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PREFACE 



The Network Operating System (NOS) was developed by Control Data 
Corporation to provide network capabilities for time-sharing and 
transaction processing, in addition to local and remote batch 
processing, on CONTROL DATA CYBER 170 Series Computer Systems; 
CDC CYBER 70 Series, Models 71, 72, 73, and 74 Computer Systems; 
and CDC 6000 Series Computer Systems. 

AUDIENCE 

This internal maintenance specification (IMS) -provides the 
systems analyst with detailed internal documentation of NOS. 
Included are detailed descriptions of system routines and the 
system interfaces, tables, and flowcharts of these . rout i nes . 
Some' user interfaces are mentioned, but these are fully described 
in other NOS manuals. 

CONVENTIONS 

Extended memory for the CYBER 170 Models 171, 172, 173, 174, 175, 
720, 730, 750, and 760 is extended core storage (ECS). Extended 
memory for CYBER 170 Model 176 is large central memory (LCM) or 
large central memory extended (LCME). ECS and LCM/LCME are 
functionally equivalent, except as follows: 

• LCM/LCME cannot link mainframes and does not have a 
distributive data path (DDP) capabi I i ty . 

• LCM/LCME transfer errors initiate an error exit, not a 
half exit. Refer to the COMPASS Reference Manual for 
complete information. 

The Model 176 supports direct LCM/LCME transfer COMPASS 
instructions (octal codes 014 and 015). Refer to the COMPASS 
Reference Manual for complete information. 

In this manual the acronym ECS refers to all forms of extended 
memory on the CYBER 170 Series. However, in the context of a 
mult imainf rame environment or DDP access, the Model 176 is 
exc luded. 

In this manual, the order of importance of headings is denoted as 
f o I lows . 

LEVEL 1 HEADINGS ARE FULL CAPS AND UNDERLINED 

LEVEL 2 HEADINGS ARE FULL CAPS 

Level 3 Headings are First-Capped and Underlined 

Level 4 Headings are First-Capped 

Conventions for central memory word formats are as follows: 
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• Cross-hatching indicates a field is not used by or is 
not applicable to a function processor. However, CDC 
reserves the right to assign these fields to system use 
in the future. 

• Fields reserved for system use are so labeled. 

• Fields labeled with mnemonics indicate a specific 
parameter must be inserted (generally described after 
the word format) . 

• Fields with numeric identifiers indicate the actual 
value that is used or returned for a particular function 

RELATED PUBLICATIONS 

For further information concerning CYBER 170, CYBER 70, and 6000 
Series Computer Systems, the N0S time-sharing systems, and the 
user interface for N0S, consult the following manuals. 



Control Data Publication Publication No. 

CYBER 170 Computer Systems Reference Manual 60420000 

CYBER 170 Computer Systems 60456100 

Models 720, 730, 750, and 760 
Model 176 (Level B) 

CYBER 70/Model 71 Computer System Reference 60453300 

Manua I 

CYBER 70/Model 72 Computer System Reference 60347000 

Manua I 

CYBER 70/Model 73 Computer System Reference 60347200 

Manual 

CYBER 70/Model 74 Computer System Reference 60347400 

Manua I 

Modify Reference Manual 60450100 

Network Products 

Interactive Facility Version 1 Reference Manual 60455250 

Network Products 

Transaction Facility Version 1 Reference Manual 60455340 

Network Products 

Transaction Facility Version 1 User's Guide 60455360 

Network Products 

Transaction Facility Version 1 

Data Manager Reference Manual 60455350 



60454300 B 



TV 



Control Data Publication 

Network Products 

Transaction Facility Version 1 

CYBER Record Manager 

Data Manager Reference Manual 



Network Products 

Network Access Method Version 1 Reference Manual 

Network Product s 

Network Access Method Version 1 

Internal Maintenance Specification 

Network Products 

Remote Batch Fac i I i ty Ve rs i on 1 Reference Manual 



Pub li cat ion No . 



NOS Version 

NOS Version 

NOS Version 

NOS Version 

NOS Version 

NOS Version 

NOS Version 

NOS Version 



Installation Handbook 

Operator's Guide 

Reference Manual Volume 1 

Reference Manual Volume 2 

System Ma i ntenance. Reference Manual 

System Programmer's Instant 



60456710 
60499500 

60490110 

60499600 
60435700 
60435600 
60435400 
604453Q0 
60455380 
60449200 



Time-Sharing User's Reference Manual 60435500 



Export/Import Reference Manual 60436200 

TAF/TS Version 1 Reference Manual 6Q453000 

TAF/TS Version 1 User's Guide 60436500 

TAF/TS Version 1 Data Manager Reference Manual 60453100 

TAF/TS Version 1 CYBER Record Manager 60456700 

Data Manager Reference Manual 

6400/6500/6600 Computer System Reference 60100000 

Manual 

DISCLAIMER 

This product is intended for use only as described 
in this document. Control Data cannot be responsible 
for the proper functioning of undescribed features or 
undefined parameters. 
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INTRODUCTION 



The Network Operating System (NOS) is a group of programs and 
subprograms that monitors the input, compilation, assembly, 
loading, execution, and output of all jobs submitted to the 
computer. NOS accepts jobs in four ways: time-sharing, local 
batch, remote batch, and system console input. NOS controls 
CYBER 170 Series Computer Systems, CYBER 70 Series, Model 71, 
72, 73, and 74 Computer Systems, and 6000 Series Computer 
Systems. 

Efficient processing of user jobs is the prime objective of the 
operating system. This section describes the inherent hardware 
characteristics, the basic software elements, and how they work 
together to accomplish the prime objective. Figure 1-1 shows the 
NOS system equipment configuration. 

HARDWARE OVERVIEW 

NOS uses peripheral processors (PP) for system and input/output 
tasks and one or two central processor units (CPU) to execute 
user and system j.obs. Central memory (CM) contains user programs; 
system software areas are located at the lower end of central 
memory. Extended core storage (ECS) may also be used by NOS. 



CENTRAL PROCESSOR UNIT 

The CPU performs tasks of a computational nature; it has no 
input/output capability. It communicates with other system 
components through central memory. Under NOS, the CPU is used 
almost exclusively for program compilations, assemblies, and 
executions. The CPU makes system requests through a CPU request 
register located at the reference address plus one (RA+1) of the 
current program in execution. However, system work that can be 
done more efficiently in the CPU is processed there. 



PERIPHERAL PROCESSORS 

The system may have up to 20 peripheral processors. The 
peripheral processors (identified as PPQ, PP1, ..., PPn) are 
identical and perform many tasks for requesting programs in 
central memory. Each PP consists of 4K, 12-bit, 1-byte words of 
memory. 

A PP can control i nput /output , j ob scheduling, control statement 
interpreting, system housekeeping, and other tasks as required. 
Tasks are assigned one at a time to each PP by the CPU monitor 
(CPUMTR). When an assigned task is completed, the PP signals 
the system. CPUMTR waits for this signal before assigning 
another task to the PP. 
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Each PP is assigned a block of eight words in central memory 
resident through which communication with the system is 
conducted. This area is referred to as the PP communications 
area. Each block contains an input register, an output register, 
and a message buffer. 



CENTRAL PROCESSOR UNIT(S) 
(SOME CDC MODELS HAVE ?) 












CENTRAL 
MEMORY 

49K* 
OR MORE 














(CHO) (CHIJ K)H2) (CH3) (CH4^ (cH5^ (cm\ (chm (CH10) (CHlT) 





6676 
MUX 



2550 
HCP 



n 



o 

CONSOLE 
DISPLAY 




TO NETWORK 
64 TTY APPLICATIONS 
LINES 



tSpecial consideration is needed for NOS to execute with 49K of 
central memory (refer to the NOS Installation Handbook). 

Figure 1-1. System Equipment Configuration 
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CENTRAL MEMORY 

Central memory words are 60 bits Long; each is composed of five 
12-bit bytes. Each 12-bit byte in a CM word is numbered 
through 4, from the Left, as follows. 



59 



byte 



47 



byte I 



35 



23 



byte 2 



byte 3 



byte 4 



One or more user programs may be in some state of execution 
concurrently under NOS. These programs are stored in central 
memory in an assigned user area called control points; a set of 
system components necessary for the operation of the system is 
also stored in central memory, forming central memory resident 
(CMR). Central memory is accessible by all PPs and CPU(s) and 
forms the communication link between all processor units in the 
computer system. 

CMR contains system communication areas, system tables, CPU 
resident routines, the library directory, and information about 
each job currently in execution. 



EXTENDED CORE STORAGE 

Extended core storage (ECS) is a high-speed peripheral storage 
device. It is used by the mu It ima inf rame software for storage 
of common tables since ECS can be accessed by two or more 
mainframes. ECS is also used to retain system routines and 
compilers that are called frequently. It is often used by the 
system to move blocks of central memory. This is known as a 
storage move of control points and is described later. ECS may 
also be used for rolling jobs out of central memory, and 
user created files, and for direct access of large data arrays 
by using the read/write ECS instructions. 



SOFTWARE OVERVIEW 

Under NOS all processing of user jobs is controlled in central 
memory. NOS consists of PP programs, CPU programs, macro 
definitions, and symbol definitions. The entire system is 
contained on a magnetic tape file produced by the NOS utility 
Modify. Programs in the library file are in source language 
form. Installation options are provided to permi t f lexib le 
selection of system features during the assembly and creation of 
an NOS deadstart (system initialization) medium. The most 
frequently used options are selected during deadstart. 

A system monitor is in complete supervisory control of the 
hardware system. The system monitor is composed of PP routine 
MTR (PP monitor) which operates in PPO, and CPUMTR (CPU monitor) 
which is loaded as part of central memory resident (CMR). 
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CENTRAL MEMORY ORGANIZATION 

The allocation of central memory is as follows. 



iow core 



t 
high core 



CMR 



CPUMTR 



CM library 



assigned to 

control points 

(system/user programs) 



Low core is allocated to the central memory resident portion of 
NOS and executable system programs. The remaining area is 
assigned to control points. 



CONTROL POINTS 

The system can control execution of several jobs at one time. 
When placed into CM before execution, each job is assigned a 
control point number. Jobs at control points are assigned to a 
processor for execution. Each control point area in CMR 
contains all the information necessary to process the assigned 
job.' 

Control Point Concepts 

Blocks of central memory storage not allocated for system use are 
ordered by control point number and assigned tp jobs. Each 
control point number has a corresponding table in CMR called the 
control point area. A control point is not a physical entity, 
but rather a concept used to facilitate bookkeeping. The control 
point number and the control point area, however, are physical 
quantities that do appear in the system. 

Under NOS up to 23 (27 octal) control points are possible. In an 
installation with n control points for user jobs they are 
numbered from 1 to n. A job assigned to a control point is 
identified by its control point number; only one job can be 
assigned to a control point at any one time. Once a job is 
assigned to a control point, system resources such as central 
memory, ECS, channels, equipment, and processors may be assigned 
to the control point for use by the job. 
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The amount of CM/ECS words assigned to a single control point 
is contiguous and an integer muLtiple of 100B for CM and 1000B 
for ECS; storage for all control points is not necessarily 
contiguous. The central memory storage block assigned to the job 
at control point 2 is higher than the block for the job at 
control point 1/ and storage for control point 3 is higher than 
that f o r cont ro I point 2, and so on. 



In the Figure 1-1 .1 no storage is assigned to control 
points 3 and 5; unassigned storage appears between assigned 
storage . 



low core 


CMR 




r 

core 


CPUMTR 




CM library 




control point 1 




control point 2 




W///////////////////, 




control point 4 




control point 6 




'/////////////////////A 


high 


control point 7 

. 



Figure 1-1.1. Central Memory Storage Layout Example 
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Subcontrol Points 

Another feature of NOS is subcontrol points. Bas i ca I ly , t he 
memory of a regular control point is divided into a number of 
distinct blocks. Various applications programs are loaded and 
executed in these blocks under the control of an executive 
program. The executive manages the subprograms and assigns the 
CPU according to priorities i t est abl i shes . The executive 
program and each subprogram is protected from other subprograms 
This protection is accomplished by the CPU as explained in 
section 3. Currently, the transaction subsystem (TAF) uses 
this feature. 



Special Control Points 

In addition to the n control points defined for running jobs, 
there are two special control points used for system control: 
control point zero and control point n+1. 

Control point zero is essentially CPU monitor (CPUMTR) which 
controls the memory of the entire machine. Also, some peripheral 
nt can be assigned by control point zero to jobs at other 




• System dayf i le 

• Account dayf i le 

• Error log dayf i le 

• Jobs in the input queue 

• Jobs in the rollout queue 

• Jobs in the output queue 



CPUMTR uses control point n+1 for certain monitor functions that 
might require a large amount of CPU time. For example, the 
delinking of tracks in a mass storage allocation table may 
require a significant amount of CPU time. Thus, this function 
is best done at control point n+1. While running at control 
point n+1, CPUMTR is in program mode, not monitor mode, and can 
be interrupted by PP exchange jumps (MXN) . However, the CPU 
priority of control point n+1 is 100 octal, which is the highest 
avai lab le . 
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Job Ro L Lout 

During the course of execution, a job might not remain 
continuously at the same control point. It is possible for the 
job to be rolled out while it is only partially executed, thus 
making CM available for higher priority jobs. When a job is 
rolled out, it is not associated with a control point. When it 
is rolled back in, it is probably associated with a control 
point other than its previous control point. 

During the time a job is rolled out, the only table in CMR that 
contains information about the job is the file name table entry 
(file type rollout). The system periodically updates the 
priorities of rolled out jobs and eventually reschedules the job 

to a controL point. 



Storage Moves 

When a job begins or finishes processing, or as jobs are rolled 
in and out, CM storage must be reallocated and jobs must be 
moved. If a job at a control point requests additional storage, 
it may be necessary to move jobs to obtain the required storage. 

A request for a reduced field length (FL or FIE) resets the 
FL/FLE size in the control point area; no storage move takes 
place, unless the field length reduction takes place at the last 
control point. A request for an increased field length, when 
unallocated storage is available and adjacent to the control 
point, results in resetting the FL/FLE size in the control point 
area; no storage move is required. 

If it is necessary to take una I located storage adjacent to other 
control points to satisfy a request for increased field length, 
control points above and below the requesting control point will 
be scanned. This scan locates the combination of unallocated 
storage blocks that will result in a move of the least amount of 
s to rage . 

In figure 1-1.1, if control point 1 needs more storage, it will 
be necessary to move control point 2. If control point 6 needs 
storage, sufficient una I located storage may be available to make 
a control point move unnecessary. If, however, control point 7 
needs additional storage, control points 4, 6, and 7 may be moved 
to provide the storage. Added storage always extends the field 
Length upward. 

Storage moves are determined by MTR and are performed by CPUMTR. 
There are three possible methods used by CPUMTR: 



Use compare/move unit (CMU) if available 
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• Use ECS block transfers if ECS is available 

• Use CPU if previously mentioned hardware is unavailable 

Job Field Length 

When a user program is assigned a control point, the system 
allocates a certain amount of CM to the control point. This 
storage is contiguous in memory and is a multiple of 100 octal 
words. The block of CM assigned is defined by a starting address 
called the reference address (RA) and a word count field length 
(FL). 



RA 

RA + 100 



RA + FL 



user/system 
communication 



user 
program 



FL(CM block assigned) 



The user program is loaded at location RA+100, with the first 100 
octal words (RA through RA+77) reserved for system communication. 
Once loaded, a user program cannot access memory beyond its 
boundaries of RA and RA+FL. The CPU uses the RA to convert 
addresses to absolute. If the program attempts to read or write 
beyond its boundaries, the CPU detects the error and aborts the 
job. Since the user program cannot access memory outside its FL, 
any area reserved for system communication must be within the FL 
of the job. Thus, the first 100 octal locations of each job's 
FL are reserved for this purpose (refer to section 2). 



PROGRAM/SYSTEM COMMUNICATION 

All communication with the system is performed by entering a 
system request in location RA+1 of the field length. ' A user 
program may communicate with the system as described in the 
following examples. 

• The CPU does not peform i nput /output . Therefore the user 
program sends 1/0 requests to the system. This is most 
often a request for the PP program CIO. 

• When a user program terminates, it must advise the system 
that it may process the next control statement. 
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If a 
prog 
bit 
aval 

call 
If C 

PP, 

CMR. 

the 

pass 

f iel 

sect 



CPU 
ram 
40 i 
lab I 

i n 
PUMT 
CPUM 
Th 
i npu 
ed f 
d, 
ion 



progr 
name a 
s set . 
e, the 
RA + 1 . 
R dete 
TR wri 
e name 
t regi 
rom a 
The f o 
2. 



am wishes to call a PP program it places the PP 
nd arguments in RA+1. If autorecall is desired, 
If the central exchange jump (CEJ) instruction is 
program should use it immediately after placing a 
This causes CPUMTR to begin execution immediately, 
rmines that the RA+1 call should be assigned to a 
tes the RA+1 word into the PP input register in 

and any parameters in bits 35 through appear in 
ster exactly as they did in RA+1. Parameters are 
CPU program to a PP program through this parameter 
rmat for the PP communication area is shown in 



For example, if the PP program CIO iscal led, CIO finds the 
relative address of the file environment table (FET) to be used 
in the operation by reading its input register. It can find the 
RA of the control point field length by reading the control point 
number from its input register, computing the address of the control 
point area, and reading the value of RA from the control point area. 
By adding the RA to the relative FET address, CIO obtains the 
absolute address of the start of the FET. CIO then reads the 
parameters for the I/O operation from the FET. 

MTR continually scans RA+1, in the event that the user's program 
does not use the central exchange jump, or the instruction is 
not available (CEJ/MEJ disabled). When an RA+1 call is found, 
MTR initiates CPUMTR. 

The following illustrates an RA+1 call with the FET address 
speci f i ed . 



RA + 1 



59 




40 


17 


XXX 


/ 
/ 
/ 


1 





FET address 



A system-forced autorecall without the FET address is as follows. 
59 40 17 

RA+1 



XXX 
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Program Recall 

The recall program status is provided to enable efficient use of 
the central processor and to capitalize on the multiprogramming 
capability of NOS. Often, a CPU program must wait for an I/O 
operation to be completed before more computation can be 
performed. To eliminate the CPU time wasted if the CPU program 
were placed in a loop to await I/O completion, a CPU program 
requests the control point be put into recall status until a 
later time; the CPU may be assigned to execute a program at some 
other control point. If there is nothing to do, the CPU executes 
an idle loop in CPUMTR. 

Recall may be automatic or periodic. Autorecall should be used 
when a program requests I/O or other system action and cannot 
proceed until the request is completed. NOS does not return 
control until the specific request has been satisfied. Periodic 
recall can be used when the program is waiting for any one of 
several requests to be completed. The program will be activated 
periodically so that it can determine which request has been 
satisfied and whether or not it can proceed. 



Periodic Recall 



a CPU program puts the characters RCL 
On encountering the RCL request, the 
a/ *•.«... »„*.»..- fc ..w «. ~ -- some other control point. After a 
certain interval of time has elapsed, the control point is 
restarted and the CPU is again assigned to execute the program at 
the control point. 



To enter periodic recall, 
left- just if i ed into RA + 1 . 
system assigns the CPU to 



Automat i c Recall 

If a CPU program makes a request in RA+1 and bit 40 of RA+1 is 
set to 1, the control point will be put into automatic recall 
after the request has been initiated. Again, the CPU is assigned 
to another control point as in periodic recall. In this case, 
however, the program in recall will be restarted by CPUMTR after 
the PP has dropped or issued the RCPM functions. The completion 
bit in the FET is never statused. The only criterion for CPU 
startup is the RCPM or PP drop CDPPM). 

Recall and autorecall are most often used while waiting for CIO 

to process an I/O request. However, any time a PP program is 

called from RA+1, with bit 40 of RA+1 set to 1, the control point 
will be put into autorecall. 
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If bit 40 is set, bits 17 through of RA + 1 must contain the 
address of a word in the program's field Length called a reply 
word. When the PP has completed its function, it will set the 
completion bit (low-order bit) in the reply word, and drop or 
issue an RCPM. The completion has no basic significance to NOS. 



For a call to CIO, the reply word is the first word of a FET. 
For ■ ot he r ' programs the reply word need not be part of a FET. 



A CPU 
p rog r 
of RA 
addre 
one o 
using 
ope ra 
RA + 1 
a CIO 
autor 
norma 
only 



program can put itself into autorecall without calling a PP 
am by putting RCL lef t-j us t i f i ed in RA+1 and setting bit 40 
+1 to 1. Bits 17 through of RA+1 must contain the 
ss of a reply word. A program which has already initiated 
r more I/O operations might go into autorecall in this way, 

the first word of the FET associated with one of the I/O 
tions as the reply word. Figure 1-2 shows the formats of 
for: a normal CIO call; a request for periodic autorecall; 

call with autorecall bit set; and an RCL call with 
ecall bit set. For periodic recall, a user must issue a 
I CIO call followed by an RCL request. For autorecall, 
one request is required. 



Any CPU program making a call to a PP program using autorecall 
needs to be restarted by the PP program unless the PP program 
intends to drop before the CPU program is started up. Just 
setting the completion bit in the pseudoFET word is not enough to 
get the CPU program restarted. In addition, the PP routine must 
issue the monitor function RCPM (request CPU) to get the CPU 
program restarted. Unless a CPU program has queue priority 
greater than MXPS 7760B), all calls to PP programs, with the 
exception of CIO, are forced into auto-recall by CPUMTR. 

Autorecall initiated by the RECALL macro is treated as follows. 
CPUMTR checks the completion bit and if set takes the CPU 
out of autorecall. If not set, CPUMTR leaves the recall 
request (RCLP) in RA+1 and exits. This request is detected 
later by MTR, and CPUMTR is called. 

Normally, CPU programs use autorecall for convenience, but only 
one request involving autorecall can be processed at one time. 
For example, to initiate I/O action on several files at once, a 
user must employ the periodic recall technique. All requests 
are issued without recall (using a separate FET for each request) 
and then periodic recall is begun. Each time the CPU program is 
restarted by the system, it can check all the files for 
completion and go back into periodic recall if any are still 
i ncomp let e. 
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CIO cat I 



59 



RA + 1 



40 



CIO 



la 



v, 





FET address 



RA + 1 



CIO call with autorecall 



59 


40 


17 


CIO ^ 


'^^^^ 


FET address 



59 



RA + 1 



Request for periodic recall 
41 



RCL 


'MMMM^M^a 



Request for autorecall 



59 



40 



17 



RA + 1 



RCL 





pseudo 
FET address 



Figure 1-2. RA+1 CIO and Request Calls 
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Periodic recall may be used also when a CPU program can initiate 
an I/O request and then perform some computation. In some cases , 
the I/O is completed before the computation; in others, the 
computation is done first. The user enters recall only when the 
computation is done, and then only if the I/O is still in 
process. 



Periodic recall should also be used, if possible, to continue 
processing while only part of the data buffer has been read or 
written by the I/O driver. 



The definitions in tables 1-1 and 1-2 are used extensively in 
NOS. A graph of CPU and CM time, slice ^figure 1""3) is provided 
to illustrate the relationships between these two concepts. 
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TABLE 1-1 



SYSTEM RESOURCE TIMES 



I tern 



Oes'c ri pt i on 



Queue priority 

CPU priority 
CPU time s Lot 
CPU time slice 
CM time slice 



The priority that governs entry to a control 
point from the INPUT or ROLLOUT queue and also 
governs disposition to a printer. 

The priority that governs which candidate for 
the CPU will access the CPU. 

The time period when the CPU is shifted from 
one candidate to another. 

The total time period that a control point can 
use the CPU without being penalized. 

The total time period a job can reside at 
a control point without being penalized. 



Penalized means that, the queue priority in the control point 
area is reduced to the lower queue priority CLQP) for the 
origin type specified. 



TABLE 1-2. JOB ORIGINS 



Source 



Origin Type 



SYOT 
BCOT 
EIOT 
TXOT 
MTOT 



System 
Local batch 
Remote batch 
Time-sha ri ng 
Mu 1 1 i-t ermi na I 
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time 
slice 



CM 
time 
slice 



CPU 
time 
slice 



y 



/\ 



when either the CM or the CPU 
time slice occurs, the job is 
penalized. 



/" 



penalize joh if CPU 
time slice has not 
occurred 



/ 



/ 



/' 



/ 



/ 



\Zz. 



y 



A 



S 



S 



*s. penalize job if CM time slice 
has not occurred 



time 



CM time 
CPU time 



CM time increases Linearly with time as long as the job is at a 
control point without respect to the use of the CPU. 

CPU time increases as a step function with a linear relation only 
while the job is actually using the CPU- 
Figure 1-3. Graph of CM Time Slice and CPU Time Slice 
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CENTRAL MEMORY AND TABLES 



Central memory resident (CMR) is the Low end of central memory. 
It is reserved by NOS and provides the major coordinating area 
for system operation. CMR contains pointers, tables, CPU monitor 
(CPUMTR), libraries, and library directories- 

The length of CMR is dependent upon several factors, including 
the number of peripheral processors/ the number of control 
points, the number of mass storage devices, and others. This 
secton gives an overview of the layout of CMR giving the 
relative positions of the various parts of CMR, in addition to 
other system def ined. tables, symbols, and codes. The CMR part 
det ai Is : 

Central memory layout 
Pointers and constants 
Control point area 
PP communication area 
Dayfile buffer pointers 
Central memory tables 
System sector format 
Ro I Lout f i Le 
The following descriptions are also provided: 
Job communication area 
Exchange package area 
Error flags 
File 'types- 
Equipment codes 
Mu It imainf rame tables 
PP memory layout 
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CENTRAL MEMORY RESIDENT 

CENTRAL MEMORY LAYOUT 



000 

077 
100 

I I I 
I 12 

122 

123 

• 

126 

127 

• 

• 

141 

142 

• 
177 

200 
(n+l)*200 

(n + 2)*200 



sy stem po in t e r s and 
con t r o 1 wo rds 


channel status 


table 


status/control reg 


tst ers 


miscellaneous pointers 


and data 


reserved 


channel release 1 


able 


control point areas 


s y s tern con t ro 1 


point 


PP commun i cat ion 
(pointer in word 002 


area 
, byte 4) 
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,d a y f i le buffer pointers 
pointer in word 003, byte 0) 



equipment status table (EST! 
(pointer in word 00 5, byte 0) 



f i le name /file status table 
{pointer in word. 004, byte 0) 



FNT interlock table 
pointer in word 004, byte 



CDC CYBER 176 
exchange package area 



mass storage 
allocation area 



mass storage tables (MST] 



job control area 



day file buffers 



dayfile dump buffer 



ECS/PP buffer 



CPUMTR 



resident peripheral library (RPL) 



resident cen tral library (RCL) 



peripheral library directory ( PLD) 



central library directory (CUD) 



system user library directory (LBD) 
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POINTERS AND CONSTANTS 



59 



47 



35 29 23 



000 

001 

002 

003 

004 

005 

006 

007 

010 



zeros 



fwa resident 

PP library 

fwa PP library 



directory 



day file 
pjur fwa 



fwa 

FNT 



fwa 
EST 



number 
of PPUs 



fwa dayfile 

dump buffer 

— 



lwa+ I 
FNT 



iwa + 
EST 



fwa mass storage 
allocation 



fwa CPU library 
directory 



lwa+1 ms 
equipment 



tl 



number of 
Ctrl pts 



memory 
size/100 



PP comm 
area adr 



fwa job control 
area 



no. excess 
day files 



fwa user library 
directory 



fwa ECS/PP 
buffer 
[7 



fwa COS 
CPU lib d 



; format ///A »^ 

irectory V//A ' 



installation area 




RPLP,PPUL, 
CPUL.MFLL 
PLDP.NCPL, 
PPCP 

DFPP 

FNTP.JBCP 

ESTP 

LBDP.MSAP 

CLOP 
INOL.INSL 



ACML.AECt 
MSCL 



JSCL 
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Ref Bit No. Description 

t 1 23-20 Unused. 

19-18 CDC CYBER 176 CPU type: 

= Not a CDC CYBER 176. 

1 -CDC CYBER 176 Model A. 

2 = CDC CYBER 176 Model B. 
3= CDC CYBER 176 Model C. 

17 Set if 2x PPs are selected. 

16 Set if machine type is CDC CYBER 

170. 
15 Set if CMU is present. 

14 Set if CEJ/ ME J option is available, 

13 Set if GPU has an instruction 

stack. 
12 Set if CPU1 is present. 

•f-2 23-12 Nonzero if dayfile dump is 

disabled. 

-f-3 5-0 ACCFAM FL/100. 

•f4 5-3 LIBDECK number. 

2-0 Recovery mode. 

•f 5 59-48 Reserved. 

■f 6 59 Scheduler active flag. 
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59 



47 



35 



23 



042 
043 
044 
045 
046 
047 
050 
051 

052 
053 
054 
055 

056 

057 

060 

061 

062 

063 

064 

065 

067 

075 
076 
077 



tl 



\z 



TELEX/IAF' 



STIMULATOR 



EXPORT/ 
IMPORT 



NETWORK 
INTER PROC 



MASS STOR- TRANSACTION! 
AGE CONTROL STIMULATOR 



BATCHIO 



RBF 



MAGNET 



CDCS 



TAF 



MCS 



reserved 



reserved 



reserved 



IR addr 
next PPU 



idle time 



load code 

for MS 

error processors 



reserved 



Ctrl point 
fqr move 



X&/SA 



v&m 



internal to MTR 



CPO Ctrl 
pt assig 



, CPI Ctrl 
2 ptasslg 



CPO exchange 
address 



CPI exchange 
address 



address of PPO 
exchange package 



first word of PP exchange package 



reserved 



zeros 



reserved 



reserved 



EQ 



CPSL 



CPUMTR exchange 
address for MTR 



PS 



IPRL 
SSTL 
SSCL 



PPAL 



MSEL 



CMCL 
ACPL 

PXPP 



ZERL 



MTRL 
CPSL 
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Ref 


Bit No. 


tl 


59-54 




53-48 




47-36 




35 




34-25 




24 




23-12 




11-6 




5 




4-0 


t2 


59-54 




53 




52 




51-50 




49 




48 




47 




46 




45 




44 




43 




42 




41 




40 




39 




38 




37 




36 




35 




34 




33 




32-15 




14 




13 




12 




11-0 


1 3 


59 


t<- 


59 



Description 

Index for CPU1 multiplier. 

Index for CPUO multiplier. 

Secondary rollout sector threshold. 

Keypunch mode (0=026, 1=029). 

Unused. 

System character set mode (0=63, 

1=64 character set). 

Assumed conversion mode (2 = 

ASCII/USASI, 3=EBCDIC). 

Assumed 9-track tape density 

(3=800, 4=1600, 5=6250). 

Assumed tape type (7-track=0, 

9-track=l). 

Assumed 7-track density (1=200, 

2=556, 3 = 800). 

Reserved for CDC use. 

Disable user ECS. 

Disable PF validation. 

Disable MS validation. 

Ignore USER statement. 

Disable account verification. 

Disable BATCHIO. 

Disable TELEX/IAF. 

Disable EI200. 

Disable MAGNET. 

Disable TAF/TS. 

Disable removable device checking. 

Disable queue protect. 

Disable secondary user statements. 

Disable SCP facility. 

Disable TAF. 

Disable NAM. 

Disable RBF. 

Disable subcontrol points. 

Disable MCS. 

Disable CDCS. 

Reserved for CDC use. 

ENGINEERING switch. 

Console initial lock status. 

DEBUG switch. 

Reserved for installation use (local), 

Set if CPUO is off. 

Set if CPU! is off. 
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59 


47 


35 




23 


17 


II 


100 


CHO 


CHI 


CH2 


CH3 


CH4 


101 


CHS 


CH6 


CH7 


CHIO 


CHI 1 


102 


CHI2 


CHI 3 


CHI4 


CHI 5 


CHI6 


103 


( unused ) 


CH20 


CH2I 


CH22 


CH23 


104 


CH24 


CH25 


CH26 


CH27 


CH30 


105 


CH3I 


CH32 


CH33 


CH34 
(unused) 


CH35 
(unused) 


106 


seconds 


mil liseconds 


107 


reserved 


1 10 


\z 


1 1 1 


T3 


^%m^^^ 


112 


t4 


113 


4 


3 


2 


I 





1 14 


9 


8 


7 


6 


5 


115 


14 


13 


12 


I I 


10 


1 16 


^^^^^ 


16 


15 


117 


4 


3 


2 


I 





120 


9 


8 


7 


6 


5 


121 


14 


13 


12 


I I 


10 


122 


^^^^^ 


16 


15 


123 


MID 


t7 


machine 
index 


124 


reserved 


125 


reserved 


126 


reserved 


flag register 


127 


J8 


130 


reserved 


MXN time 


worst case 
MTR cycle time 


current MTR 
cycle time 


131 


count of ECS moves 


count of CM moves 


132 


rollout count 


count of sectors rolled 


133 


reserved 


user commits + time 
slice with output 


count of time slices 


134 


reserved 


4 


obs in recall due to 
P priority exchanges 


135 

• 
• 
• 

162 


reserved 


163 

• 
• 
• 

177 


PSD-1DS communication area 



CTIL T1 



RTCL 
PFNL 

SCRL 
SI6L t5 



S36L?6 



MMFL 



EFRL 

INWL 

SDOL 

SDIL 

S02L 

S03L 

S04L 
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Bit No.-. Description 

Channel status table; one byte per 
channel, each with the following 
bit descriptions. 

Bit Description 



11 Set if channel requested. 

10-7 PP number of requesting 

PP. 

6 Set if channel not 

available. 
5-0 PP assigned. 

t2 .59-56. Reserved. 

55 Total PF system interlock. 

54 Request total PF system interlock. 

53-48 PF activity count. 

47-18 Reserved. 

17-12 Default family equipment number. 

11-6 Alternate family count. 

5-1 Reserved. 

Word interlock. 

■f-3 59-48 Seconds left until label check. 

47-36 Seconds left until devices check- 

pointed. 

•j-4 59 Set to inhibit MTR from calling 

1MB for S/C register error pro- 
cessing. 

58 Set if error processing ignored at 

deadstart. 

57 Set to allow MTR to accept DSRM 

function for emergency step from 
1MB, and to prevent DSD from 
allowing UNSTEP command to be 
entered. 

56 Set to indicate MTR has set step 
mode on request from 1MB 
(emergency step). 

55-36 Unused. 

35-24 Real-time clock from RTCL, in 

seconds /lOOOg, at which the last 
threshold count or time interval 
was exceeded for single SECDED 
errors. 

23-12 SECDED count. 

11-0 Threshold count. 
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Ref Bit No. Description 

|5 -- * The channel 16 S/C register con- 

tents, words through 16 (bits 0- 
203). 

t6 -- The channel 36 S/C register con- 

tents, words through 16 (bits 0- 
203). 

t7 47-42 Reserved. 

41-36 Equipment number of link device. 

35 Set if this machine has DATI 

recovery interlock. 

34-30 Unused. 

29-24 Count of devices with initialize 

pending that have not been check- 
pointed. 

23-20 Machines active. 

19-16 Machines down. 

15-12 Machine mask. 

t8 59-15 Unused. 

14 Disable priority evaluation. 

13 Disable job scheduler. 

12 Disable autoroll. 

11-2 Unused. 

1 Fatal mainframe error flag. 

System control point (SCP) sub- 
system abort interlock. 
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CONTROL POINT AREA 



59 



47 41 



35 29 



23 



000 



01 7 
020 

02 1 
022 
023 
024 
025 
026 
027 
030 



034 
035 
036 
037 
040 



exchange package area 



|1 



error flags 



activity 
count 



RA/100B 



job name 



CPU 
riority 



queue 
priority 



T2. 



CM residence time limit |3 CPU time slice limit 



job 
orgn 



FL/100B 



operator 
equipment 



CPUs allowable 



time entered X status 



t4 



reserved 



ECS 
RA/I000B 



ECS 
FL/IOOOB 



PP recall register 



ts 



snse 
swchs 



message 1 area 



STSW 

JNMW,OAEW 

JCIW 

TSCW 

CPCW 

ECSW, CPIW 

RLPW 

SNSW 
MS1W 



message 2 area 



047 

050 
05I 
052 
053 
054 
055 
056 
057 
060 



nstallation area 



Is 



SRU accumulator (micro units#lO) 



CP accumulator 



MS accumulator 



M13 = M1*M3 



M1* 1000 



MT accumulator 



PF accumulator 



M14=M1*M4 



adder accumulator 



M12=M1*M2 



I + , CPM (SRU = SRU + 
< T~ T7 CPM*CP) 



SRU accoupt 
block limit 



reserved 



reserved 



SRU job 
step limit 



CP time job 
step limit 



IN7W 

ACTW.SRUW 
CPTW 
IOAW 

MP1W.ADAW 
ACTWE.MP2W 
MP3W 
STLW 
SRJW 
CP time at beginning of job step CPJW 



reserved 



I.OM (SRU = SRU + I0M*I0) 



computed SRU job step limit 



SRU at beginning of job step 



MS2W 



IMOW 
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Ref Bit No. Description 



|2 

t3 

t4 



t 5 



t6 



59 


CPU W status. 


58 


CPU X status. 


57 


CPU auto recall (I status). 


56 


CPU subcontrol point active status 


55-54 


Unused. 


53 


Job advancement flag. 


52-48 


Number of PPs assigned to job. 


35-33 


CPU status for rollout. 


32-25 


Unused. 


24 


Set if rollout is requested. 


35 


Set if CPU time slice is active. 


34-30 


Queue control (0 -input, l=rollout). 


59-51 


Job control flags (reserved). 


50 


Return private user files. 


49 


Set privacy ID on new files. 


48 


Preserve ECS over job steps. 


47 


FNT interlock. 


59 


Reserved. 


58 


026/029 punch mode. 


57 


Set if OVERRIDE required to drop 




job. 


56-36 


Unused. 


35-24 


Reserved for installation use. 


23-15 


Reserved. 


14 


Subsystem idledown flag. 


13 


NOGO flag. 


12 


PPU pause flag. 


Limit flags: 




59 


Time validation limit. 


58 


Time limit. 


57 


SRU validation limit. 


56 


SRU limit. 


55 


Control statement limit. 


54-48 


Reserved. 


Overflow flags: 


47 


MS accumulator. 


46 


MT accumulator. 


45 


PF accumulator. 


44 


AD accumulator. 


43-42 


Reserved. 



•f 7 59 Disable SRU accumulation if set, 
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59 



53 47 



35 29 



23 



17 



061 

062 

063 

064 

065 

066 

067 

070 

071 

072 

073 

074 

075 

076 

077 

100 

10 1 

102 

103 

104 

105 

106 

107 

I 10 

I II 

112 
I 13 

114 

• 

127 
130 



177 



tl 



t2 



t3 



roilin FL 



rollin 
ECS FL 



FL increase 
request 



ESC FL 
increase req 



t4 



TXOT 



list of files 
address 



TTY interrupt 
address T5 



auxiliary pack name 



user number 



Ts 



input FST 



primary FST 



Tl2 



T'I3 



eq 
num 



til 



t9 
terminal input\ 



output pointer 



te 



— f7 user index 



jointer 



error exit ||0 
return address 



event descriptor 



control statement 
count 



first track 



job sequence 
number 



reserved 



reserved 



current 
track 



next state- 
ment index 



current 
sector 



control statement 
address (TCS) 



rollout 
time 



limit index 



half sector 
flag. 



demand file 
random index 



tl4 



dayf ile msg 
count 



control 
stmt count 



Tl5 



mass storage 
PRU count 



each bit has a special meaning 



buffer 
length 



buffer address 



buffer 1 
length 



buffer 1 address 



special entry point word "f|6 



system processor call word "|"I7 



EFG 



EF 



|I8 



R1G 



R'3 



input buffer 
address 



CCL data 



R2 



right screen 
buffer address 



reserved 



left screen 
buffer address 



loader control words "fl9 



t20 



FWA of dump 



reserved 



t2l 



computed CP job step limit 



FPFW 
FLCW 
ELCW 

SSCW 

TXSW.TIOW, 
TIAW, LOFW 

PFCW 

UIDW 

EECW,TINW 

TFSWJERW 

CSPW 

CSSW 

RFCW 

ALMW 

ACLW 

AACW 

ICAW 

SEPW 

SPCW 

JCDW 

JCRW 

DBAW 

LB1W 

LB2W 

LB3W 
PPOW 

SSOW 
CPLW 



reserved 



control statement buffer 



CSBW 
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Bit No. Description 

59 Set when first charge processed. 

58 Set if second entry in level-3 block. 

57-48 Reserved. 

47-36 SRU validation limit. 

35-24 FNT ordinal of PROFILE file. 

23-12 Track of level-3 block, 

11-0 Sector of level-3 block. 

t2 59-48 Maximum field length (MFD for 

current job step. 
47-36 Initial running field length; always 

less than or equal to MFL (value 
of zero indicates system field 
length control). 
35-24 Maximum field length for entire job; 

MAX FL is upper bound on MFL. 

t3 .59-48 Maximum ECS field Length (MFL) 

for current job step. 

47-36 Initial running ECS field length; 

always less than or equal to MFL 
(value of zero indicates system 
ECS field length control). 

35-24 Maximum ECS field length for en- 

tire job; MAX FL is upper bound 
on MFL. 

T4 59-48 Rollout indicators (one bit per 

subsystem) indicating the user job 
is a candidate for normal rollout. 
47-0 Connection indicators (four bits 

per subsystem) representing par- 
ticular subsystem the user job is 
communicating with. 

f5 35-17 Previous error flag value if bit 58 

set in word EECW indicating ex- 
tended RPV mode. 

f6 17-12 Family EST ordinal. 

11-0 Indexes into tabLes of limits. 

11-9 Limit for size of direct access files. 

8-6 Limit for number of permanent files. 

5-3 Limit for cumulative size of indirect 

access files- 
2-0 Limit for size of indirect access 

files. 

|7 17 Set if charge statement is required. 
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Ref Bit No. Description 

•f8 59 No exit flag. 

58 Extended RPV mode. 

57 Interrupt handier in progress flag 

(extended RPV mode only). 
56 Set if one-time error previously 

entered (extended RPV mode only). 

55-48 Unused. 

47 For nonextended RPV mode, set if 

bits 46-36 are error flag instead of 

reprieve error option. 
46-36 Error flag or reprieve error option 

for nonextended RPV mode. 
47-36 Mask bits for extended RPV mode. 

+9 17 Job reprieved. 

-MO 17-0 RPV parameter block address (ex- 

tended RPV mode only). 

+ H 30 Valid event descriptor present. 

•fl2 59-54 Job class, 

53-48 Reserved. 

47 Set if EOR is on control statement 

file. 

+ 13 59 Set if information is for INPUT 

file. 
58 Skip to EXIT flag. 

57-54 Unused. 
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Ref Bit No. 


Description 


tl4 47-45 


Magnetic tapes. 


44-42 


Removable packs. 


41-39 


Deferred batch jobs. 


38-36 


Local files. 


35-30 


Time limit. 


29-24 


SRU limit . 


23-18 


Field length. 


17-12 


ECS field length . 


11-6 


Lines printed. 


5-0 


Cards punched. 



•fl5 23-18 Disposed output count. 

+ 16 59 Set indicates presence of entry- 
points. 

58-54 Reserved. 

53 Set if ARG- entry point present. 

52 Set if DMP= entry point present. 

51 Set if SDM= entry point present. 

50 Set if SSJ= entry point present. 

49 Set if VAL= entry point present. 

48 Set if SSM= entry point present. 

47-36 Reserved. 

35 Restart flag. 
34 Reserved. 

33 Suppress DMP- if control statement 

call. 
32 Create DM* file only flag. 

31 Dump FNTs with control point area . 

30 Leave DM* file unlocked. 

29-18 DMP= FL/100 (if field is 0, dump 

entire FL). 
17-0 SSJ= parameter block address. 

tl7 For input: 

59-42 Entry point if RA+1 request, 

770000B if control statement call. 

41 Special program request active 

(1AJ only). 

40 Clear RA+1 upon completion. 

39 If set, parameter list is in bits 

35-0; if clear, address of param- 
eter list is in bits 17-0. 

38 Does not start CPU at completion 

of control statement call (1AJ only). 

37 DMP= Initiation in progress. 

36 Unused. 

35-0 Refer to description of bit 39. 

For output: 

59-36 Unused. 

3 5-24 Status return. 

23-0 Unused. 
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Ref Bit No. Description 

•(•18 59 Disable dumps. 

58-56 Unused. 

55 ECS common memory manager flag, 

54 CM common memory manager flag. 

-f 19 LB1W: 

59 Use default map options if not set. 

58 Reserved. 

57 Local map option X. 

56 Local map option E. 

55 Local map option B. 
54 Local map option S . 
53 Reduce flag. 
52-36 Reserved. 

35-24 CDC CYBER Interactive Debug 

control byte . 
23-0 Global library set indicators 

(6-bit fields): 
00 End of library set. 

01-76 LBD ordinal of system 

library. 
77 User library; logical file 

name of first user library 
in LB3W; logical file name 
of second user library in 
LB2W. 
LB2W, LB3W: 

59-0 Either logical file name of second 

(LB2W) or first (LB3W) user 
library, or a collection of 6-bit 
global library set indicators. 

f 20 47-36 ECS FL of program making DMP= 

call. 
35-24 Field length of program making 

DMP= call. 
23-18 Dump word count. 

•f-21 12 Swap out (SF.SWPO) in progress. 

11-0 Subsystem outstanding connection 

count. 
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PP COMMUNICATION AREA 





59 


47 


41 


35 


INP 
REG 


name of 
PP program 


tl 


parameters 


OUT 
REG 


monitor 
fnct code 


parameters 




message buffer 
(6 words) 



IA 
OA 
MA 



DAYFILE BUFFER POINTERS 



59 


47 


35 


23 


II 


twa dayflle buffer 


no. words 
in buffer 


length of 
buffer 


T2 


eq no 


first 
track 


current 
track 


current 
sector 


'W///A 



Ref Bit No. 
t 1 41 

40-36 
t2 11-0 



Description 

Set if called with auto recall. 

Control point assignment. 

Interlock byte (0 = no dump in 
progress, 1 = dump in progress) 



60454300 A 



2-18 



CENTRAL MEMORY TABLES 



Equipment Status Table (EST) Formats 



Mass Storage Device 



59 



47 41 35 



23 



fl 


t2 


t3 


14 


J-t«4 dev 

, I I5 'yp e 


address/IO 
of MST 



Nonmass 


Storage 


Device 


(3 


000 Type 


Equipment) 


59 52 47 41 35 


23 M 




t6 


cpt 
assg 


chB 


chA 


tT 


I ,Q type 


18 





Ref Bit No, 



tl 



59 
58 
57 
56 
55 
54 

53 
52-48 



Description 

Set to indicate mass storage device, 
Set if device has copy of system. 
Set if shared device. 
Set if removable device. 
Set if 844/885 disk type equipment. 
Set if device is not currently avail- 
able for access. 
Set if equipment is down. 
Reserved. 



t2 

|3 

T4 



f 5 



47 Channel down bit. 

46-42 Alternate channel. 

41 Channel down bit. 

40-36 Primary channel. 

For 844/885 disk type equipment: 
35-24 Zero. 

For other equipment types: 

3 5-33 Physical equipment number. 

32-30 Zero. 

29-27 Device selection for connect code, 

2 6-24 First physical unit for device. 



23 



ON /OFF flag (set if access not 
allowed). 
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Ref Bit No. Description 

-f-6 59 Unused. 

58 Allocatable device. 

57-56 Unused. 

55 Set if 580 PFC printer. 

54 Set if V carriage control processed. 

53 Set if equipment is down. 

f 7 For unit record equipment: 
35-24 Forms code. 

For other equipment: 
35-30 Channel D. 

29-24 Channel C. 

| 8 For magnetic tape equipment: 

11-9 Equipment number. 

8-4 Flags: 

01 GCR (1600/6250) tape unit. 

02 Disable block-ID (66x only). 
04 Reserved. 

10 6 7x tape unit. 

20 66x tape unit. 

3-0 Unit number. 

For other equipment types : 
11-9 Controller number. 

8-6 Print train (if applicable). 

5-0 Unit number. 

For unit record equipment: 
5-0 ID number. 
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Equipment Codes 

Code Description 

CP Card punch (3446/3644-415). 

CR Card reader (3447/3649-405). 

DE Extended core storage.! 

DI-n Disk storage subsystem (7x54-844-21). 

DJ-n Disk storage subsystem (7x5x-844-4x/ 

44). 

DK-n Disk storage subsystem (7154-844-21). 

DL-n Disk storage subsystem (715x-844-4x). 

DM-n Disk storage subsystem (7155-885). 

Dp Distributive data path to ECS. 

DQ-n Full-track disk storage subsystem 

(7155-885). 

DS Display console. 

LP Line printer. 

LR Line printer (580-12). 

LS Line printer (580-16). 

LT Line printer (580-20). 

MS Mass storage device. 

MT Magnetic tape drive (7-track). 

NE Null equipment. 

NP 255x Host Communications Processor. 

NT Magnetic tape drive (9-track). 

ST Remote batch multiplexer (6676 or 

2550-100). 

TT Time-sharing multiplexer (6676, 

6671, or 2550-100). 



| ECS subequipment values exist in associated MST. 
The values are in word DILL (byte 3) and further 
define the type of ECS equipment. 
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File Name/File Status Table (FNT/FST) Entry 



File In Input Queue 



59 


53 


47 


35 


23 


17 


1 


5 


job name 


job 
org 


type 
INFT 


-T- 


Id 
code 


eq 

no 


first 
track 


binary card 
sequence no 


field 
length 


queue 
priority 



File in Print Queue 



59 


53 


47 


35 




7 


1 


5 


job name 


job 
org 


type 
PRFT 


Xt, 


T2 


eq 
no 


first 
track 


t3 


queue 
priority 



File in Punch Queue 



59 


53 


47 


35 


7 


1 


5 


job name 


job 
org 


type 
PHFT 


+«' 


t2 . 


eq 

no 


first 
frack 


t3 


queue 
priority 



File in Rollout Queue 



59 


53 


47 


35 


23 


7 


1 


5 


job name 


job 

org 


type 
ROFT 


4-n 


id 
code 


eq 
no 


first 
track 


ECS 
FL/IOOOB 


field 
length 


queue 
priority 



File in Timed/Event Rollout Queue 



59 


53 


47 




35 


23 


17 


II 


5 


job name 


job 
org 


type 
TEFT 


i 


event 
des 


eq 
no 


first 
track 


event 
descriptor 


field 
length 


rollout 

time pd 
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Mass Storage Files 

Not in Input, Print, Punch, or Rollout Queue 



59 


53 


47 


35 


23 


7 


1 




5 , 9 


file name 


t5 


file 
type 


1 cp 

4ti 


id 
code 


eq 
no 


first 
track 


current 
track 


current 
sector 


'/, 


16 



Magnetic Tape Files 



59 


53 


47 


35 


29 


7 


i 


5 





file name 


M 


file 
type 





cp 


id 
code 


eq 
no 


UDT addr 

assig tp 


f8 


VSN entry 
random address 


4-19 t6 



Fast Attach Permanent Files 



59 


53 


47 


35 


23 


7 


1 


5 


fl le name 


tio 


type 
FAFT 


cp 


til 


eq 
no 


first 
track 


user ct 
REAOMD 


us ct 
RDAP 


us ct 
READ 


t!2 



Ref Bit No. 



fl 



T2- 


59- 


57 




56- 


54 


13 


35- 


33 




32- 


12 


T4 


5 




T5 


17 
16 
15 
14 
13 
12 




?6 


10 

9 

8 
7 
6 






5-4 




3-2 




1 
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Description 

Set if system sector contains control 
information. 

Device selection field. 
External characteristics- 

Forms code. 

Terminal identification (TID). 

Set if user job has subsystem connection 
(either long term connection or wait 
response). 

Unused. 

Set if extend- only file. 

Set if alter- only file. 

Set if execute- only file. 

Unused. 

Write lockout. 

Unused. 

Indicates the track interlock status 

of LIFT files (mass storage only). 

Set if file is opened. 

Set if file is written since last open. 

Set if file is written on. 

Unused. 

Read status (0 = incomplete read, 

1 = EOR, 2 = EOF, 3 = EOI). 

Set if last operation write. 

Clear if busy status . 
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Ref 
f 8 



|9 
f 10 



Bit No. 


Description 


17-14 


Unused. 


13 


Set if opened. 


12 


Write lockout. 


35-32 


Data format: 




I 




1 SI 




2 F 




3 S 




4 L 


31-30 


Reserved. 


11 


Set if labeled tape . 


17 


Unused. 


16 


Set if modify. 


15 


Set if append. 


14 


Set if execute . 


13 


Set if write . 


12 


Set if read. 



til 59-54 Fast attach entry index in ECS (if 

globally fast attach), if local fast 
attach file. 

|12 11-9 Write attach mode (7 = write, 

3 = modify, 1 = append). 
8-1 Unused. 

Clear if busy status. 
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File Types 






Files in Queues 




Type 


Value 


Description 


INFT 





Input . 


ROFT 


1 


Rollout . 


PR FT 


2 


Print. 


PHFT 


3 


Punch . 


TEFT 


4 


Timed /event rollout 


Special Queue 


Files 




Type 


Value 


Description 


SIFT 


5 


Special file type 1. 


S2FT 


6 


Special file type 2 . 


S3 FT 


7 


Special file type 3 . 


Other Files 






Type 


Value 


Description 


LIFT 


10 


Library. 


FTFT 


11 


Primary terminal. 


PMFT 


12 


Direct access 
permanent file. 


FAFT 


13 


Fast attach file. 


SYFT 


14 


System . 


LOFT 


15 


Local. 



Job Origin Cod e$ 



Type 

SYOT 
BCOT 
EIOT 



Value 


1 
2 



Description 

System. 
Local batch. 
Remote batch . 



TXOT 
MTOT 



Time-sharing. 
Multiterminal. 
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Mass Storage Allocation (MSA) Area 



000 

001 

002 

003 

004 

005 

006 

007 

008 



59 


47 


u 


last 
temp eq 


temporary devicest 




last 
input eq 


input file devicest 


last 
out put eq 


output file devicest 


last 
rollout eq 


rollout file devicest 


last 
dayfileeq 


user dayf ile devicest 




last 
primary eq 


primary filedevices* 


last 
localeq 


local file devicest 


last 
LGO eq 


LGO file devices'!" 


last secondary 
rollout eq 


secondary rollout file devicest 



|Bit 47- eq is set for each equipment with the 
allocation type selected. 
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Mass Storage Table (MSTj 





59 51 


47 40 


35 


23 1 


7 


1 


5 


000 


tl 


W///A 


TRT length 


T2- 


no. avail, 
tracks 


001 


t3 


user ECS 
first track 


file count 


IOFT 
track 


t4 


002 


ECS address of MST/TRT 


ECS MST/TRT update 


cnt 


T5 


003 


1st track 
IAF 


label 
track 


permits 
track 


no. catalog 
tracks 


OAT 
track 


004 


family or pack name 


DN 


m 


Te 


005 


user number for private pac 


k 


T7 


006 


t8 


driver 
name 





sector 
limit 


007 


W/////////////////////y, 


WM 


W////A 


010 


installation area ( 


global) 




1 1 


mm^^^ 


W/M 


W////a 


012 


activity 
count 


unit 
interlocks 


current 
position 


MTR 
internal 


ECS 
error # 


013 


t9 


014 


dAyPilE I ACCOUNT 
track | track 


ERRLOG 
track 


system table 
track 


tio 


015 


til 


user count 


Tl2 


016 


1 13 


017 


installation area 



TDGL 

ACGL 

SDGL 

ALQL 

PFGL 

PUGL 

MDGL 

R1GL 

ISGL 

I2GL 

DALL 

DILL 

DULL 

STLL 

DDLL 

ISLL 



Ref Bit No, 



tl 
t3 



f 4 



59-48 

23 
22-12 

59 
58 

57-52 
51-48 

11 
10-7 



3-0 



Description 
Number of tracks on device. 

NOS format MST. 

First available track word pointer. 

CT1 present. 

System deadstart file present. 

Reserved. 

Global interlock (machine mask). 

Redefinition requested flag. 

Redefinition reply bits (machine 

masks). 

Set if sector of local areas is 

present. 

Unload (all machines). 

Device error idle status: 

No error, 

1 Error detected on device. 
Permanent file utility active 
(machine mask). 
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Ref Bit N o. Description 

•f 5 5-4 Reserved. 

3-0 Interlock (machine mask). 

| 6 5-3 Relative unit in multiunit device. 

2-0 Number of units in multiunit device, 

j- 7 17 Catalog track contiguous with label 

track. 
16 Catalog track overflow (O). 

15-8 Secondary device mask. 

7-0 Device mask. 

f 8 59 Removable (R). 

58 Auxiliary permanent file device (X), 

57 Sixteen-word PFC device. 

56 Device last checkpointed on MMF 

system (in label section only). 
55-48 DAT entry index. 

47 Half track status (l=half, 0=fuil) 

46 Release reservation when channel 
released. 

45 Reserved. 

44-36 Single-unit sector limit. 

| 9 59-48 Mass storage allocation flags. 

47 715x controller present on second 
channel. 

46-42 Second channel in CMRDECK in 

definition of EQ. 
41 71 5x controller present on first 

channel. 
40-36 First channel in CMRDECK in 

definition of EQ. 
35-24 Unused. 

23-22 Reserved. 

21 Maintenance mode set (ECS). 

20-18 Memory type: 






No CPU. 


1 


ECS I. 


2 


ECS II. 


3 


LCME. 


4-7 


Reserved. 
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Ref Bit No. Description 

17-15 CPU type: 

No CPU path. 

1 ECS. 

2 LCME. 
3-7 Reserved. 

14-12 PP path type: 

No DDP. 

1 DC145 parity enhanced DDP. 

2 DC135 DDP. 
3-7 Reserved. 

11-6 Unused. 

5-0 Algorithm index for 844/885 disk 

monitor function. 

•f- 10 11 Family idle down status. | 

10-0 Family activity count. 

f 11 59 Format pack (844/885 disk | 

equipment). 
58 Half/full track initial requeues. 

57 Initialize permanent files (I). 
56 Initialize IQFT (I). 

55 Initialize DAYFILE (I). 

54 Initialize ACCOUNT (I). 

53 Initialize ERRLOG (I). 

52 Initialization (HT/FT) (I). 

51 Unloaded in this machine (L). 

50 Checkpoint requested (C). 

49 TEMP (T). 

48 Alternate system device (A). 

47-42 Reserved. 

41-36 Error status. 

3 5-24 A 2-character machine identification. 

| 12 11-6 Multiple equipment link. I 

5-3 Original number of units. 

2 Device in use. 

1 Local utility interlock. 

Local area interlock. 

■f 13 59 Redefinition in progress (drive I 

reserved). 

58 Null equipment indicator. 
57-54 Reserved. 

53-48 Number of units minus 1. 

47-0 Unit list, ordered right to left, 

6 bits per unit. 
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Track Reservation Table (TRT] 



Word Format 





59 47 


35 


23 


1 







track 

link 


track 
link 


track 
link 


track 
link 


ti 


1 


Re 


f Bit No. 




Description 





tl 11- 



7-4 
3-0 



Each bit set indicates correspond- 
ing byte (0 through 3) is first track 
of a preserved file. 
Track interlock bits. 
Track reservation bits. 



Track Link Byte (Format i; 



Bit 

11 
10-0 



Contents 

Set. 

Next track in track chain. 



Track Link Byte (Format 2) 



Bit 

11 
10-0 



Contents 

Clear. 

End of chain (EOl sector in file). 
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Machine Recovery Table (MRT] 



Word Format 



59 


31 


unused 


tl 



Ref Bit No. 
tl 31-0 



Description 

Each bit represents one logical 
track (bits 10-5 of the logical 
track number denote the word 
number in the MRT and bits 4-0 
are the bit numbers within the word). 



The meaning of the MRT bit depends upon the state 
of the track interlock bit in the TRT. 



Track Inter- 
lock Bit 



1 
1 



MRT 
Bit 





Description 

Track is not interlocked or it 
is local to another machine. 

First track of a file is local 
to this machine. 

Track is interlocked by 
another machine. 

Track is interlocked by this 
machine. 
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Job Control Area (JCB 



59 



One 

for 

each 

origin 

type 

and 

job 

class 



47 



35 



23 



in. queue 
priority 



in. queue 
priority 



in. queue 
priority 



init. CPU 
priority 



max jobs 
or users 



tl 



lower 
bound 



lower 
bound 



lower 
bound 



CPU time 
slice 



max FL 
any )ob 



upper 
bound 



upper 
bound 



upper 
bound 



CM time 

slice 



max FL 
oil jobs 



priority 
age intvl 



priority 
age intvl 



priority 
ageintv 




cur. intvl 
count 




max ECS FL 
any job 



rnaxEC 
all jobs 



reserved 



reserved 



INQT 
ROOT 
OTQT 
SVJT 

PFCT 
ETB 



Ref Bit No. 



Description 



tl 59-48 Index into tables of limits. 

59-57 Index a table of limits for size of 

each direct access file. 
56-54 Index a table of limits for number 

of permanent files. 
53-51 Index a table of limits for cumulative 

size of indirect access files. 
50-48 Index a table of limits for size of 

each indirect access file. 



Libraries/Directories 



Resident CPU Library (RCL) 



Type OVL 

59 



program name 



17 



length ( links 

to next program) 



Type ABS 

59 



length (links 
to next program) 
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Resident PPU Library (RPL) 



59 




41 


35 


23 


II 


package 


name 


m 


load 
address 


WM, 


length 
(links) 



PPU Library Directory (PLD) 
CM Resident 



59 41 35 


23 


1 


package name 


1 RPL address 


length 


load 
address 



Non-CM Resident 

59 41 35 



23 



package name 


h 


track 


sector 


load 
address 



CPU Library Directory (CLP) 
Type OVL 
59 47 23 17 II 5 



program name 



t2 



m 



?3 



track sector 



Tvpe ABS 
59 47 



23 17 II 5 



name of first entry point 


t 


2 


no, 
epts 


u 


*3 


track 


sector 


additional entry point names 
(one per word) 


W, 


WM 



Tvpe PROC 
59 



23 17 



procedure name 


- 


W//W/A 


*^^^^ 


random address bias 
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Type REL 



59 


47 


23 


17 


it 


5 


program name 


t2 


no. 
epts 


W/M 


T3 


track 


sector 


additional entry point names (one per word) 


wwm 



U ser Library Directory (LBD) 
Type ULIB 



59 






23 


17 




1 





1 i brary name 


1 


m 


m, 


^^^M^ 


random 


address 


bias 



Ref Bit No, 



f 1 41-36 



t 2 



17-15 

14 

13 

12 

11-6 



T3 47-24 



t4 59-48 
T5 17 



Description 

Alternate device or system device 
equipment number. 

Unused. 

Relocatable record flag. 
NOS/BE record flag. 
Unused. 

Alternate device equipment num- 
ber. 

If program is CM resident, field 
contains the absolute address in 
RCL. If program is assigned to 
alternate system device, field has 
mass storage address of copy on 
system device. 

FL required (use of bits 59 and 
58 indicate MFL= entry point) . 

Set if CCL procedure* 
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SYSTEM SECTOR FORMAT 
Standard Format 





59 


47 




35 23 


I 


I 


000 


fnss 


001 


eqss 


ftss 


rtsss 


Wfr. 


2 


fass 


002 


dtss 


003 
007 


1 


IP 


W 


Hlfillll 


Wem 


010 


t1 


jfss /scss 


on 


jess /less 


jess 


crss 


iff^ 


t2 012 


rcss 


rtss 


rbss 


^^ 


013 


t s s 


prss 


miss 


flss 


014 


less 


ecss 


f ess 


dvss 


dcss 


015 


dass 


016 


fdss 


odss 


017 


diss 


y///////////A 


y ////m 


020 


fsss 


021 


fmss 


ooss 


022 


acss 


023 


cdss 


024 


j n s s 


025 


ohss 


026 








dhss 




027 


frss 


030 

* 
• 

046 


vass 

/ 


047 
050 


reserved 


051 

• 
• 
• 

062 


ubss 
(user data block ) 


063 

* 

• 

• 

077 






iillll 


Wm 



■f 1 For print/punch files, pfss (bits 47-36), rass (bits 
35-12); for input files, jsss (bits 59-36), bits 35-24 
unused, jtss (bits 23-12). 

■f 2 For input files, bits 59-18 are defined as terminal 
name (tnss). 
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The following apply to all system sectors. 

fnss FNT entry, 

eqss Equipment number. 

ftss First track, 

nsss Next sector. 

fass Address of FST entry, 

dtss Last modification date and time 
(packed format). 

The following apply to input files only. 

jsss Job sequence number. 

jtss Job time limit. 

jfss Job flags. 

jess Job statement CM field length. 

jess Job statement ECS field length. 

crss Cards read. 

tnss Terminal name. 

The following apply to print /punch files only. 

pfss Punch format. 

rass Random address of dayfile . 

scss Spacing code for 580 PFC support. 

less Lines or statement limit index . 

rcss Repeat count . 

rtss Random index . 

rbss Requeue number. 

The following apply to all queued files. 

otss Origin type. 

prss Priority. 

miss Machine ID. 

flss File size (sectors/lOs). 

icss Internal characteristics. 

ecss External characteristics . 

fess Forms code . 

dvss Device code. 

dess NOS/BE device code. 

dass Destination user number . 

fdss Destination family name . 

odss Family ordinal of destination (future). 

diss Destination terminal identification (TID). 

fsss FST entry. 

fmss Family name of creator. 

ooss Family ordinal of creator (future). 

acss User number of creator. 

edss Queued file creation date and time . 

jnss Job statement name. 

ohss Origination host name (future). 

dhss Destination host name (future). 

frss File routing control. 

vass Account file validation block. 

ubss User block. 
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Direct Access File System Sector Format 
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000 

001 
002 

003 

• 

• 
007 

010 

01 I 

012 

013 

014 

015 

016 

017 

020 

• 

• 
025 

026 

027 

030 

031 

032 

033 

034 

035 

036 

• 

072 
073 

076 




y///y/yyyyy^/yy control modification date and ti 



radom index 



access count 



CT 



mode 



EF 



EC 



ON 



creation date and time 



data modification date and time 



last access date and time 




user control word 



inetaltaf ion word 




reserved for installation 



CTSS 



Permonent File 
Catalog Entry 



UCSS 
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eqss Equipment number. 

ftss First track. 

ucss Current user counts: 

RM READMD users. 

RA READAP users. 

R READ users. 

Ref Bit No. Description 

| 1 59-49 Zero. 

48 Set if enhanced EOI sector present. 

| 2 59-54 Reserved. 

53 File has been purged. 

52 File can be shortened (W mode). 

51 File can be rewritten (W or M mode), 

50 Zero. 

49 File can be extended (W, M, or A 
mode). 

48 Zero. 

■f 3 47-36 Fast attach (40xx); upper bit set 

indicates file is in fast attach 
mode and lower 6 bits (41-36) con- 
tain index into ECS tables if file 
is global fast attach. 

| 4 47-37 Zero. 

3 6 Local write flag (file attached in 

W, M, orA mode). 
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ECS Direct Access Chain 





59 47 35 23 17 || 5 





000 


** UECS. 


^LIFT 


m 


001 


eqss 


f tss 


W///////////////////^ 


002 


W////////////A 


dt ss 


003 


^^mm^m^m^ 


004 


mid 1 


f 1 1 


In1 


ra1 


It1 


005 


mid 2 


ft 2 


ln2 


ra 2 


It 2 


006 


mi d3 


ft 3 


In3 


ra3 


1 1 3 


007 


mi d4 


ft4 


In4 


ro4 


It -4 



cqss 

ftss 

dtss 

mid 

ft 

In 

ra 

It 



Equipment number. 

First track. 

Last modification date and time (packed 
format). 

Machine ID. 

First track of subchain. 

Length of ECS block. 

RAE of ECS block. 

Last track of subchain. 
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ROLLOUT FILE 

System Sector 

000 



007 
01 



0! I 
012 




dayflle buffer pointer 



! 3 
I 4 



027 
030 



037 
040 



input file FNT entry 



list of equipment assigned to job 
(terminated by zero word) 



SSJ = parameter block 



057 
060 



terminal table contents 
at last rol lout 



terminal table contents 
for recovery 



077 
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File Format 



control point area 



dayfile buffer 



FNT entries 
terminated by logical record 



t 
terminal output 

terminated by logical record 



central 
memory 



extended 

core 
storage 



central 
memory 



O(CM) 



FL-MCMX/2-1 (CM) 
O(ECS) 



FL-I(ECS) 
FL-MCMX/2 (CM) 



FL-l (CM) 



f This part of the rollout file is used only for TXOT 
jobs. 
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JOB COMMUNICATION AREA 



RA 

RA+I 
RA-t-2 




RA + 27 
RA+47 



RA + 64 
RA + 65 

RA + 66 

RA+67 
RA+70 



parometers from the program 
call statement 

(available to user during job execution) 



special program parameter area 



H — 

1 J7 



reserved 



t4 



RA + 77 
RA-MOO 

RA+IIO 



reserved 



job orig 
type 



reserved 



Ref 



16 



number of 
parameters 



next word avail 
for loading 



I st word of 
object program 



TtB 



reserved 



control statement image 
(maybe replaced by operator message) 



loader area 



ARGR 



SPPR 



PGNR.ACTR 

CMUR.LWPR 

XJPR.JOPR 
FWPR 
CSMR 
LDRR 

CCDR 



Bit No. 



fl 


14 




13 




12 


|2 


40 


t3 


59 


|4 


18 


|5 


59 


t 6 


23-20 




19 




18 


|7 


59 


t8 


29 



Description 

CFO bit if console forced operator 
command is allowed. 
Subsystem idledown flag. 
Pause flag. 

Auto recall. 

Set if compare /move unit (CMU) 
is present. 

Set if load from system library. 

Set if CEJ/MEJ option is available. 

Reserved. 

Set if program called from D1S. 

RSS bit. 

Set indicates system is in 64- 
character set mode. 

Set if load has completed. 
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EXCHANGE PACKAGE AREA 

Exchange package area for CDC CYBER 170 Series, 
Models 171, 172, 173, 174, 175, 720, 730, 750, and 
760; CDC CYBER 70 Series, Models 71, 72, 73, and 
74; and CDC 6000 Series Computer Systems. 





59 




53 


47 41 


35 


17 





000 


P 


P 


AO 


BO 


001 


M 


RA 


Al 


B 1 


002 


n 


FL 


A2 


B2 


003 


EM 


W////, 


A3 


B3 


004 


1 


RAE 


A4 


B4 


005 


1 


FLE 


A5 


B5 


006 


m 


MA 


A6 


B6 


007 


w////////////, 


A7 


B7 


01 


xo 


01 1 


X 1 


12 


X2 


01 3 


X3 


1 4 


X4 


1 5 


X 5 


1 6 


X6 


01 7 


X7 
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Fxchange package area for CDC CYBFR 170 Series 
Model 176 Computer Systems. 





59 




53 


35 


17 


000 


Wa 


P 


AO 


BO 


001 


W, 


RA 


Al 


Bl 


002 


w, 


FL 


A2 


B2 


003 


w 


PSD 


A3 


B3 


004 


1 


RAE 


A4 


B4 


005 


1 


FLE 


A5 


B5 


006 


m 


NEA (MA) 


A6 


B6 


007 


y/A 


EEA 


A7 


BT 


010 


xo 


01 1 


XI * 


012 






X2 




013 


X3 


014 


X4 


015 






X5 




016 


X6 


017 


X7 
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The exchange package area fields apply to all NOS 
computer systems unless otherwise noted. 

Field Description 

P Program address. 

Ai Address registers. 

Bi Increment registers. 

RA Reference address for central memory. 

FL Field length for central memory. 

EMf Exit modes. An exit mode is selected 

by setting the appropriate bit and dis- 
abled by clearing the appropriate bit. 

Bit Description 

59 CM data error, ft 

58 CMC input error, ft 

57 ECS flag register operation 

parity error, tf 
56-53 Not used. 
52-51 Hardware error exit status 

bits.ftt 

50 Indefinite operand, 

49 Operand out of range. 

48 Address out of range. 

PSDtftt Program status designator (PSD) 
register. 

Bit Description 

53 Exit mode flag. 

52 Monitor mode flag. 

51 Step mode flag. 

50 Indefinite mode flag. 

49 Overflow mode flag. 
48 Underflow mode flag. 

47 LCME (ECS) error condition. 

46 CM error condition. 

45 LCME block range condition. 

44 CM block range condition. 

43 LCME direct range condition. 

42 CM direct range condition. 

41 Program range condition. 

40 Not used. 

3 9 Step condition. 

38 Indefinite condition. 

3 7 Overflow condition. 

36 Underflow condition. 



t Does not apply to CDC CYBER 170 Series, Model 176. 
tt CDC CYBER 170 Series, Models 171, 172, 173, 

174, 175, 720, 730, 750, and 760 only. 
ttt CDC CYBER 70 Series, Model 74 only. 
tttt CDC CYBER 170 Series, Model 176 only. 
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Field 



Description 



RAE Reference address for ECS. 

FL£ Field length for ECS. 

MA Monitor address. 

NEA| Normal exit address. 

EEAf Error exit address. 

Xi Operand registers. 



ERROR FLAGS 



Error flag 


Mnemonic 


1 


ARET 


2 


PSET 


3 


PPET 


4 


CPET 


5 


PCET 


6 


TLET 


7 


FLET 


10B 


TKET 


11B 


SRET 


12B 


FSET 


13B 


ODET 


14B 


RRET 


15B 


OKET 


16B 


SSET 


17B 


ECET 


20B 


PEET 


21B 


SYET 


22B 


ORET 



Description 

Arithmetic error. 

Program stop. 

PP abort. 

CPU abort. 

PP call error. 

Time limit. 

File limit. 

Track limit. 

SRU limit. 

Forced error. 

Operator drop. 

Operator rerun. 

Operator kill. 

Subsystem abort. 

ECS parity error. 

CPU parity error. 

System abort. 

Override error condition, 



t CDC CYBER 170 Series, Model 176 only. 
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MASS STORAGE LABEL FORMAT 



DEVICE LABEL TRACK FORMAT 



000 


label sector 


001 

• 

; • 

• 

012 


track reservation table 


013 


sector of local information (2-word entries) 


014 


device information sector 


15 


intermachine communication area (ECS label track only) 


016 


MMF environment tables (ECS label track only) 


017 


CPUMTR storage move area for ECS (ECS label track only) 



DEVICE LABEL SECTOR FORMAT 



000 
001 






reserved 




002 










003 


label 
level 


equipment 
type 


reserved 


004 










005 
006 






reserved 




007 










010 










• 
• 
• 






NOS MST 




027 










030 










• 
• 
• 






unused 




077 
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MULTIMAINFRAME TABLES 

INTERMACHINE COMMUNICATION AREA 



000 




e 

• 


communication area 


• 




006 




007 




• 




• 


communication area 1 


• 




015 




016 


• 


• 




• 


• 


• 
067 


• 


070 




• 




• 


communication area 10 


• 




076 





<;ach communication area has the following format, 

59 47 35 23 II 



000 


FN 


m 


w. 


MI 


MP 


MD 


001 






message 


word 1 






002 






message 


word 2 






003 






message 


word 3 






004 






message 


word 4 






005 






message 


word 5 






006 






message 


word 6 







FN 
MI 
MP 
MD 



Intermachine function number. 
Machine initiating request. 
Machines to process request. 
Machines clone processing request 
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MMF ENVIRONMENT TABLES 



Sector 16 o of the ECS label track is defined as follows 
o 





39 


47 


II 


000 


MMFL for mainframe 1 


001 


MMFL for mainframe 2 


002 


MMFL for mainframe 3 


003 


MMFL for mainframe 4 


004 


multi- mainframe 1 system time 


005 


multi-mainframe 2 system time 


006 


multi -mainframe 3 system time 


007 


multi-mainframe 4 system time 


010 


next DAT 
track 


^^^m^ 


DAT count 


01 1 


W///A 


^^^^%%%^ 


FAT count 


012 

• 
• 
• 

033 


One word per flag register bit. Each 
word contains the MMFL word of the 
machine which currently has the cor- 
responding flag register interlock. 


034 


machine 1 requests 


035 


machine 2 requests 


036 


machine 3 requests 


037 


machine 4 requests 


040 


machine 1 requests 


041 


machine 2 requests 


042 


machine 3 requests 


043 


machine 4 requests 


044 

• 
• 
• 

067 


unused 


070 

• 

■ • 

• 

077 


installation area 
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MMF - DAT TRACK CHAIN (ECS; 



Track N 
0000 

• 
0777 
1000 



device access table (DAT) 



fast attach table (FAT) 



Track M (same format for each device) 



0000 

• 
• 

001 1 


MST for shared device 
(global area) 


0012 




• 


local area for machine index 1 


0017 




0020 




• 
• 


local area for machine index 2 


0025 




0026 




• 
• 


local area for machine index 3 


0033 




0034 




• 
• 


local area for machine index 4 


0041 




0042 




• 
• 


unused 


0077 




0100 




• 
• 


TRT for device 


1077 




1 100 




• 
• 
• 


MRT1 
(machine recovery table) 


1 177 




1200 




• 
• 
• 


MRT2 


1277 




1300 




• 
• 
• 


MRT3 


1377 




1400 




• 


MRT4 


1477 
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MMF - ECS FLAG REGISTER FORMAT 



59 


17 





flag register 



Bit Set 



Name 



17-12 
11 


7 COMI 


10 
9 

8 


CIRI 

FATI, 

PFNI 

IFRI 


7 
6 
5 

4 


BTPJ 
PRSI 
DATI 
TRTI 



3-0 



Description 

Reserved . 

CPUMTR intermachine 
communication request present. 
CPUMTR interlock recovery . 
FAT and PFNL interlock. 

Intermachine function request 

interlock. 

Block transfer in progress. 

Deadstart ECS preset in progress. 

Device access table interlock. 

TRT interlock; machine. 

specified by bits 3-0 is requesting 

a TRT interlock. 

Machine mask indicating which 

machine has TRT interlock bit 

set. 



DEVICE ACCESS TABLE (DAT) ENTRY 





59 




17 


II 


000 


family name/pack name 


dn 


MST 
pointer 


001 





status 



dn 

MST pointer 

status 



Device number. 

If zero, device is not shared. 

Bits 11-5 are reserved, bit 4 

is set if recovery is in progress, 

and bits 3-0 are machine mask 

of machines accessing device- 
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FAST ATTACH TABLE (FAT) ENTRY - GLOBAL 





59 


47 


35 




23 


17 


II 


000 


fast attach file name 


W///////A 


00! 


v ///////y, 


first trk 


RM 


RA 


R 


WM 


002 


mach. 1 ID 


W/M 


RM 


RA 


R 


WM 


003 


mach. 2 ID 


WM 


RM 


RA 


R 


WM, 


004 


mach. 3 ID 


WM 


RM 


RA 


R 


WM 


005 


mach. 4 ID 


V//M 


RM 


RA 


R 


WM, 


006 


family name 


dn 


W/M 


007 






RM RL'OADMD users. 

RA READAP users. 

R Read /write users 

dn Device number . 



PFNL ENTRY FORMAT - GLOBAL 



000 
001 
002 
003 
004 
005 
006 
007 






PFNL (global) 


PFNL for 


mainframe 


1 


PFNL for 


mainframe 


2 


PFNL for 


mainframe 


3 


PFNL for 


mainframe 


4 









The first entry of the FAT is an 8-word entry of 
PFNL words in the preceding format. 
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PPU MEMORY LAYOUT 



PPO - SYSTEM MONITOR (PPU PORTION; 



0000 r 



0100 



DIRECT CELLS 



SYSTEM 

MONITOR 

PP PORTION 



7777 
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PP1 . SYSTEM DISPLAY DRIVER (DSD) 



0000 



DIRECT CELLS 



SYSTEM 
DISPLAY 
DRIVER 



C0MMAN0 OR SYNTAX OVERLAY 



LEFT SCREEN OVERLAY 



RIGHT SCREEN OVERLAY 
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POOL PROCESSORS 

(PP2 through PP11 on 10 PP machines; PP2 through 
PP11 and PP20 through PP31 on 20 PP machines. ) f 



0000 



0070 



0073 
0074 
0075 

0077 
100 



1073 



DIRECT CELLS 



READ ONLY CONSTANTS 



CONTROL POINT ADDRESS 



COMMUNICATION AREA ADDRESS 



PPU RESIDENT 

AND 

MASS STORAGE DRIVER 



PROGRAM 

AND 

OVERLAYS/BUFFERS 



| PP numbers are in octal notation. 
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DISK DEADSTART SECTOR FORMAT 
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II 


000 

9 


initial program load (IPL) executable code 


067 






070 


common test and initialization (CTI) pointer 


area 


071 






072 


maintenance software (MSL/CMSE) pointer 


area 


073 






074 


deadstart diagnostic sequencer (DOS) pointer 


area 


075 






076 


operating system (NOS) pointer area 




077 




T 



T - IPL transfer address -1 (7420 8 ) 
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MTR/CPUMTR 



CPU AND PP MONITORS 

NOS utilizes two monitors: CPUMTR (central processor monitor) 
which controls CPU monitor mode execution and CPU scheduling; and 
MTR (peripheral processor monitor) which is in general control of 
the system and operates in PPO. 

These two monitors work together, yet independently to allow the 
system to run smoothly and effectively. 

Figure 3-1 is an overview of system interaction showing both 
monitors as a controlling entity, PPs communicate with the CPU 
and vice versa through MTR by means of input registers (IR), 
output registers (OR), and RA+1 calls. 

Figure 3-2 shows the i nteract i on between this monitor concept and 
PP resident using the PP IR and OR. 

Figure 3-3 shows the monitor interaction between the CPU, PP, and 
each monitor using the exchange jump feature. With the central 
exchange jump/monitor exchange jump (CEJ/MEJ) option, the CPU 
program can either wait for MTR to call CPUMTR by finding RA+1 
nonzero, or the CPU program can directly call CPUMTR. PP routines 
may either wait for MTR to call CPUMTR by finding the OR nonzero 
or call CPUMTR directly. Without the CEJ/MEJ option, CPU routines 
and PP routines must wait for MTR to call CPUMTR for them. 

Figure 3-4 shows the entry points for CPUMTR, while tables 3-1, 
3-2, and 3-3 show the monitor functions processed by CPUMTR. 



PP 
Communications 



User 

Control 

Point 







Area 






both 
monitors 










input reg. 




pool T* 








processor / 


output reg.* 










— ► 












message 
buffer 








us 
pro 


* 

ter 

gram 







RA 
RA+1 



RA+1 00 



Figure 3-1. System Interaction 
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3-1 



monitor 




assign PP to this 
control point 



monitor checks 
this PP's 
output register 



clear I R and OR 
and indicate 
this PP is free 



PP communications area 



control point 
number 



program name 



load parameters 



message buffer 



program name 



DPPM 



PP resident 




load and 
execute the 
requested program 



inform 
monitor of 
end of operation 




no 



Figure 3-2. System Interaction 
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CEJ/MEJ ( PP 

option present I resident 



MXN 


CPUMTR 


XJ 




ra + i y 


■ \ n 
\. PP output 

\. register 








MXN 





control 
point 



MTR 



no 

CEJ/MEJ 

option 




Figure 3-3. Monitors Interaction 
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Entry 


Name 


MTR 


PMN 


PPR 


PRG 



IDL 
IDL1 



Desc ri pt ion 

From CPU program 

F rom PP moni to r 

From pooL PP program 

Address where system control point begins 
execution in program mode. When system 
control point exchanges to the CPUMTR, CPUMTR 
begins execution at MTR 

From CPUMTR. These are idle loops for CPO 
and CP1 respectively 



Figure 3-4. CPUMTR Entry Points from Exchange Packages 
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ALL system interaction is effected using the exchange jump 
instructions. 

The executable code of CPUMTR begins at the end of the dayf i le 

dump buffer. 

Functions processed by MTR for pool PPs enter CPUMTR at PPR (the 
value determines that the function is intended for MTR). 



TABLE 3-1 



VALUES OF MTR FUNCTIONS 



I Name | 


Value | 


I — — I 


1 1 


I 


2 I 


! CCHM | 


3 | 


i DCHM | 


4 | 


| DEQM | 


5 | 


| DFMM | 


6 I 


I 


7 | 


| SEQM 


10 - I 


I PRLM 


11 | 


I RCHM 


12 | 


| REMM 


13 I 


I REQM 


14 | 


I ROCM 


15 I 


| RPRM 


16 j 


I RJSM 


17 | 


I ~~ 


20 | 


| RSTM 


21 | 


I 


2 2 | 


I DSRM 


23 | 


| ECXM 


24 | 


| T6PM 


25 I 


I TSEM 


26 | 


I DEPM 


27 | 


I DRCM 


I 30 | 


I SCPM 


I 31 | 


I EATM 


I 32 | 


| DSWM 


I 33 | 


I 


| 34-35 | 



D e s cr i p t i o n 



Unas si gned 

Unas signed 

Check channel 

Drop channel 

Drop equipment 

Issue dayfile message 

Unas si gned 

Set equipment parameters 

Pause for storage relocation 

Reserve channel 

Request exit mode 

Request equipment 

Rollout control point 

Request pri or i ty 

Request job sequence number 

Unassigned 

Request storage 

Unassigned 

DSD requests 

ECS transfer 

I AT /TEL EX get pot 

IAF/TELEX request 

Disk error processor 

Driver recall CPU 

Select CPU(s) allowable for job 

execution 
Enter access system event table 
Driver seek wait 
Unas si gned 
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Functions processed by CPUMTR, enter CPUMTR at PPR. 

TABLE 3-2. VALUES OF CPUMTR FUNCTIONS 



Name | Value | 



Desc ri pt ion 



ABTM 
CCAM 
CEFM 
DCPM 
SFIM 
DTKM 
DPPM 
ECSM 
RCLM 
RCPM 
RDCM 
IAUM 

ACTM 
RPPM 
RSJM 
RTCM 
SFBM 
STBM 
UADM 
SPLM 
JACM 
DLKM 
TDAM 
TIOM 
RLMM 
LCEM 
CSTM 
CKSM 
LDAM 
VMSM 
PIOM 

MXFM 



36 
37 
40 
41 
42 
43 
44 
45 
46 
47 
50 
51 

52 
53 
54 
55 
56 
57 
60 
61 
62 
63 
64 
65 
66 
67 
70 
71 
72 
73 
74 
75 
76 



Abort control point 

Change CP assignment 

Change error flag 

Drop CPU 

Set FNT interlock 

Drop tracks 

Drop PP 

ECS t ransfer 

Recall CPU 

Request CPU 

Request data conversion 

Interlock and update fields in 

CMR/ECS 
Accounting functions 
Request PP 

Request job scheduler 
Reserve track chain 
Set file busy 
Set track bit 

Update accounting and drop PP 
Search peripheral library 
Job advancement control 
Delink track chain 
Transfer data 
Tape I/O processor 
Request time or SRU limit 
Load central program 
Clear storage 
Checksum specified area 
Load disk address 
Validate mass storage 
PP 10 via the CPU 
Unass i gned 
Maximum number of functions 
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Functions issued by MTR (only) and processed by CPUMTR enter 
CPUMTR at PMN. 

TABLE 3-3. MTR FUNCTIONS PROCESSED BY CPUMTR IN 
MONITOR MODE 



I Name 


Value I 


i ARTF 


1 I 


I IARF 


2 | 


I EPRF 


3 i 


I MRAF 


4 | 


I MFLF 


5 | 


I S CS F 


6 | 


I SMSF 


7 | 


I CMSF 


1 | 


I ROLF 


11 | 


I ACSF 


12 | 


I PCXF 


13 | 


I ARMF 


14 | 


j MREF 


15 | 


| MFEF 


16 | 



Desc ri pt i on 



Update running time 

Initiate auto recall 

Enter program mode request 

Modify RA 

Modify FL 

Reset CPU I status 

Set monitor step 

Clear monitor step 

Set rollout required 

Advance CPU switch 

Process alternate CPU exchange 

Advance running time MMF mode 

Modify ECS RA 

Modify ECS FL 



MTR functions processed by CPUMTR in program mode enter CPUMTR 

at MNR (table 3-4). Table 3-5 lists RA+1 requests processed by 
CPUMTR. 

TABLE 3-4. MTR-CPUMTR PROGRAM MODE REQUESTS 



Name | Value | 



Desc ri pt ion 



MSTF 
PDMF 
PMRF 

MECF 




Storage move 

Process down machine 

Process intermachine function 

request 
Move ECS storage 
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TABLE 3-5. RA+1 REQUESTS PROCESSED BY CPUMTR 



Name 



Description 



ABT 
CPM 



END 
LDR 
LDV 
LOD 
MEM 
MSG 
PFL 
RCL 
RFL 
RSB 
SIC 

SPC 
TIM 
XJP 
XJR 



Abort 
Resi de 

16 

24 

25 

32 

33 

37 

43 

45 

50 

55 

61 

62 
Termi n 
Reques 
Reques 
Reques 
Reques 
Send m 
Set (P 
P Lace 
Reques 
Read s 
Send i 

*1 
Proces 
Reques 
Ini t i a 
Proces 



control point 

nt CPM functions: 

Read error exit 

Read job control word 

Write job control word 

Return user number 

Read FL control word 

Read TELEX subsystem 

Read special entry point word 

Read first loader control word 

Read machine ID word 

Read ECS FL control word 

Read list of files pointer 

Set list of files pointer 

ate current CPU program 

t overlay load 

t loader action 

t autoload of relocatable File 

t memory 

essage to system 

) and change field length 

program on recall 

t field length 

ubsystem program block *2 

ntercontrol point block to subsystem 

s special PP requests *3 
t system time 
te subcontrol point *4 
s exchange jump request 



*1 Honored for jobs with QP less than MXPS, SSJ= or 

access bit CCSTP) set 
*2 Honored for jobs with QP greater than MXPS or SSJ= 
*3 Honored for jobs with QP greater than MXPS 
*4 Allowed only when subcontrol points are enabled 

(SUBCP block is loaded) 
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MTR FUNCTIONS 

The following paragraphs describe the MTR functions- The format 
for the calls are contained in the NOS Systems Instant and the 
external documentation of MTR and CPUMTR using the control 
statement DOCMENT. 

CCHM (3) - CHECK CHANNEL 

This function allows a PP to have a channel checked for 
availability. If the channel is free/ it is assigned; if not, 
the channel requested bit (bit 1) in the CST is set. Control is 
returned to the PP immediately (compare with RCHM). 

DCHM (4) - DROP CHANNEL 

Sets assignment for this channel in the CST bits 10-7 to zero. 
It is used to release the channel reserved with RCHM or CCHM. 
This function is used by the PPR routine DCH. This also does a 
release unit reserve function when the device is MS and the R 
option is set for a dual access controller. Refer to the CMRDECK 
mass storage EST entry in the NOS Installation Handbook. 

DEQM (5) - DROP EQUIPMENT 

This function releases the equipment by setting bits 52-47 of the 
EST entry to zero. It is used to release equipment reserved with 
the AEQM or REQM. 

DFMM (6) - PROCESS DAYFILE MESSAGE 

This function allows a PP to send a dayfile message to any of the 
system or control point dayfiles. Used by the PPR routine DFM. 

SEQM (10) - SET EQUIPMENT PARAMETERS 

Depending upon subfunction code, this function performs one of the 
following. 

ON equipment (set bit 23 of EST) 

1 OFF equipment (clear bit 23 of EST) 

2 Set channels for access in EST 

3 Set equipment mnemonic in EST 

4 Set byte of EST 

5 Set byte 1 of EST 

6 Set byte 2 of EST 

7 Set byte 3 of EST 
10 Set byte 4 of EST 
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PRLM (11) - PAUSE FOR STORAGE RELOCATION 

Any PP which determines that its control point has a storage move 
request pending (CMCL word 57 byte 0) must issue this function. 
MTR will not move the control point until all PP activity for 
that control point has recognized the requested move via PRLM, 
DSWM, or DFMM. This function is used by the PPR routine PRL. 

RCHM (12) - REQUEST CHANNEL 

This function sets the CST bits 10-7 to the control point number, 
thereby assigning the channel for the up to four channels 
available. The RCHM will not return control to the PP until the 
channel can be reserved. Compare with the CCHM which returns 
control whether the channel can be assigned or not. 

REMM (13) - REQUEST EXIT MODE 

This function sets the exit mode in the exchange package to the 
speci f i ed 12 bits. 

REQM (14) - REQUEST EQUIPMENT 

This function allows the PP to request an equipment. Control is 
returned whether the equipment is available or not. 

ROCM (15) - ROLLOUT CONTROL POINT 

This function sets the rollout requested bit (bit 24 in word JCIW 
of the control point area). A PP routine cannot force a job to 
rollout immediately; it must request ro I lout act ion. CPUMTR 
determines when the job may be rolled out and 1AJ is then called. 

RPRM (16) - REQUEST PRIORITY 

This function sets the CPU or queue priority in the control point 
area (word J CIW) . 

RJSM (17) - REQUEST JOB SEQUENCE NUMBER 

This function returns the current job sequence number from 
central memory word JSNL, and increases it by one. 
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RSTM (21) , -REQUEST STORAGE 

This function allows a pp routine to change the FL/FLE at a 
control point. The request is the amount of FL desired at the 
control point. If the request is for the same amount of FL or 
less than that a I ready ass i gned, t hen the request is honored 
immediately (unless, for the last control point). If the request 
is for an increase, storage moves may be necessary. Control is 
returned immediately in any case. If a PP wishes to reduce FL it 
should make this request. If it wishes to increase FL it should 
use the common routine COMPRSI to make increase storage requests. 

NOTE 



The cont ro I poi nt 
pendi ng . 



may be moved while this function is 



DSRM (23) - DSD REQUESTS 

This function is only accepted from DSD; any other PP will be 
hung. When the operator types in STEP, UNSTEP, DATE, or TIME, 
DSD issues this function. STEP mode forces MTR to accept only one 
function at a time under direction of DSD. MTR steps CPUMTR and 
controls the processing of those functions (refer to SMSF). DSD 
can specify whether to step the system or only one control point. 
MTR reissues all CPUMTR funct i ons . that were stepped when an 
unstep is issued from DSD. The subfunction to set emergency 
step is also allowed from 1MB. 

ECXM (24) - ECS TRANSFER 

This function is used to transfer data between ECS and CM. The 
transfer is between a relative address in CM to/from a relative 
address in ECS. The function also allows the specification of 
an alternate response address. This allows the calling PP to 
overlap other monitor functions with this function. 

TGPM (25) - IAF/TELEX GET POT 

This is used to get a pot chain from 'IAF/TELEX. ' It is useful 
because the PP does not need to interrupt or start up IAF/TELEX 
for the request. 

TSEM (26) - PROCESS IAF/TELEX REQUEST 

Used to request various procedures from IAF/TELEX. 



DEPM (27) ■- DISK ERROR PROCESSOR 

Used for mass storage error processing 

DRCM (30) - DRIVER RECALL CPU 
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Used to issue an RCLM if the CPU is in periodic recall status. 
This function allows the PP to request MTR to determine the CPU 
status and issue an RCLM rather than do it itself. This request 
does not require an exchange jump; therefore the PP needs only 
to place the request in its OR and does not need to wait for it 
to be processed. This is critical for mass storage or tape 
drivers, that could lose a revolution or tape speed if it needed 
to wait for a CPUMTR request. However, the routine must wait for 
OR to clear before again issuing this function. Thus, mass 
storage drivers must wait for OR to clear. 

SCPM (31) - SELECT CPUS ALLOWABLE FOR JOB EXECUTION 

Sets byte 4 of the JCIW word of the control point area to zero 
for any CPU, one for CPU only, and two for CPU 1 only. A 
selection of CPU 1 is ignored if user ECS is assigned. 



EATM (32) 



ENTER/ACCESS SYSTEM EVENT TABLE 



Enter or read events to or from system event table. 



CPUMTR FUNCTIONS 

ABTM (36) - ABORT CONTROL POINT 

Abort the control point to which this PP is assigned. Sets PPET 
error flag and performs a DPPM. 

CCAM (37) - CHANGE CONTROL POINT ASSIGNMENT 

Used to change the control point assignment for this PP. It 
reduces the PP count in the control point at STSW bits 52-48 in 
the old control point assignment, and increases it by one for 
the new control point assignment. 

CEFM (40) - CHANGE ERROR FLAG 

Replaces bits 47-36 in STSW word of the control point area. It 
is used to set or clear the error flag. 

DCPM (41) - DROP CPU 

If control point is in W status it is placed in zero status. 
Since there is PP activity the control point will not be 
advanced . 

SFIM (42) - SET FNT INTERLOCK 

Sets or clears an interlock bit for a particular FNT entry. The 
interlock bit for each FNT entry is kept in the FNT interlock 
table which is appended to the FNT. The interlock on an 
individual FNT entry should be held for the shortest time 
possible to avoid performance degradation. 
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This technique is used in the following circumstances. 

• Bringing an input file into execution 

• Performing a job advance 

• Rolling in or rolling out a job 

• Terminating a job 

• Altering the FNT or system sector of a queued file 
o Moving a file from one queue to another 

• Assigning a queue file to a control point 
DTKM (43) - DROP TRACKS 

This is executed in program mode and is used to drop trailing 
tracks from a track chain. 

DPPM (44) - DROP PP 

This is the last function issued before a PP jumps to its idle 
loop. It signifies that this PP routine is done and the PP is 
available for other assignments. 

ECSM (45) - ECS TRANSFER 

Used to get from 1 to 100B words transferred from ECS to/from 
absolute or relative CM. Also used to set/clear flag register 
and read display information for DSD/DIS. 

RCLM (46) - RECALL CPU 

Used to change the control point status from periodic recall to 
CPU candidate; that is, X status to W status. 

RCPM (47) - REQUEST CPU 

Used to start the CPU for this control point and set the control 
point status to W. This function is also used by a PP program 
called with autorecall to bring the CPU back into execution to 
i t s cont ro I poi nt . 

RDCM (50) - REQUEST DATA CONVERSION 

Used to convert 30-bit integer to FORTRAN F10.3 
display code format. 

IAUM (51) - INTERLOCK AND UPDATE 

Used to interlock and update fields in CMR or ECS. 

ACTM (52) - ACCOUNTING FUNCTIONS 
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Performs the following accounting functions. 
o Begin account block 
<• Compute SRU multipliers 

• Accounting block change 

• Compute and convert elapsed SRUs 

• Compute accumulators 

• Increment accumulator 

RPPM (53) - REQUEST PP 

Used to start a PP routine in some other PP. The response 
indicates whether the PP was assigned or none available. A PP 
can read PPAL and determine in advance if a PP is available. 
This saves time and overhead. 

RSJM (54) - REQUEST JOB SCHEDULER 

This function is used to interlock scheduler calls, so that only 
one copy of 1SJ is running at one time in the system. 

RTCM (55) - REQUEST TRACK CHAIN 

This is executed in program mode. Allows the PP routine to 
request a specified number of sectors and reserve the proper 
track chain. When no equipmet is specified one is selected based 
upon the allocation parameter in the call. 

SFBM (56) - SET FILE BUSY 

Used to interlock the FNT/FST entry for a specific file. A PP 
issues this function to reserve the file and when done releases 
the file by setting bit of the FST to one. SFBM sets bit of 
the FST to zero. This function is used to interlock any word in 
CM, such as PFNL, or any word in the MST. If SFBM is issued for 
an FNT/FST, the file name word must also be provided to check 
that another PP has not dropped the file just after the PP 
issuing SFBM found it. In both the FST and the FET, the file is 
busy when bit is clear. 

STBM (57) - SET TRACK BIT 

This is executed in monitor mode unless the system control point 
is active; then it is done in program mode. Used to set the w, 
d, or i bits in the TRT. 

UADM (60) - UPDATE ACCOUNTING AND DROP 

SPLM (61) - SEARCH PERIPHERAL LIBRARY 

Used to search PLD for a PP routine. 
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JACM (62) - JOB ADVANCEMENT CONTROL 



Options 1, 2 , ' 3 r 
advancement flag 
PP routines 
CPUMTR will 
to the j ob. 
advancement 



and 4 are used to set or clear the job 
at a control point with implied DPPM if desired, 
should not call 1AJ directly for job advancement, 
decide when a job needs to be advanced and call 1AJ 

1AJ then decides if the control point needs 
or rol lout . 



DLKM (63) - DELINK TRACKS 

This is executed in program mode. DLKM is used to drop 
intervening tracks on an existing file chain and relink the file 
chain properly. An example is PFM delinking an indirect access 
file chain in response to a user issuing a PURGE on a file which 
is long enough to completely cover several tracks. PFM attempts 
to keep the indirect access file chain to a minimum size when 
possib le . 

TDAM (64) - TRANSFER DATA BETWEEN MESSAGE ■ BUF FER, JOB 

Allows a PP to transfer up to 6 words from/to the message buffer 
to/from a job. The address to transfer to/from is a relative 
address. The transfer must be to/ from a subsystem. It 
alleviates the problem of a PP finding the subsystem and deciding 
if it is ready for reception of data. This is equivalent to the 
SIC/RSB facility except no intercontrol point communication area 
i s necessary. 



TIOM (65) - TAPE I/O PROCESSOR 



Th is 
then 
poi nt 
assi g 
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word, 
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accounting information; that is, 
d in MTUW word 53 of the control 
ction is to CCAM to change the PP 
point. If the completion code is 
is cleared, the FET is set 
count is decremented in STSW 
this function when it completes a 
Since the UDT and the FET must be 
fferent control points, this 
y keeping the control point and 
ch other. UDT must be cleared 
or an I/O sequence error could 



RTLM (66) - REQUEST CPU TIME LIMIT 

Used to change the CPU time limit in CTLW word, bytes 2, 3, and 4 
in the control point area. The time limit exceeded flag in ACTW 
word, byte is cleared. 

LCEM (67) - LOAD CENTRAL PROGRAM 

This is executed in program mode. Used to load an ECS or CM 
resident routine into the control point field length. 
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CSTM (70) - CLEAR STORAGE 

Used to clear a specified amount of CM or ECS. When clearing an 
FNT/FST entry, CSTM can also be used to set the control point 
area FNT interlock (ECSW word, bit 47). 

CKSM (71) - CHECKSUM SPECIFIED AREA 

Checksum area from FWA to LWA + 1 and compare to checksum in 
message buffer (MB). 

LDAM (72) - LOAD DISK ADDRESS 

Used to convert from logical to physical addresses for 844 
equi pment s . 

VMSM (73) - VALIDATE MASS STORAGE 

This function validates a mass storage device's MST and TRT by 

checking track reservation and preserved file track count 

against the count in the MST. Also, critical track chains are 
va I i dated. 

PIOM (74) - PP 10 VIA CPU 

This function is used by the 6DE driver to transfer data to/from 
ECS via the PP buffers immediately preceding CPUMTR. 

MXFM (76) - MAXIMUM FUNCTION NUMBER 

This is used by a PP when it desires to hang itself for some 
reason it considers catastrophic. CPUMTR will see that is is out 
of range and will hang the PP. Whenever a PP issues this 
function it should allow the analyst to clear the PP's output 
register and complete its operation gracefully. 

A PP is hung when one of the monitors determines that a function 
is illegal. For example, function out of range, or RCHM on some 
nonexistent channel. If CPUMTR hangs a PP the message PP HUNG is 
displayed at the system control point. 

If MTR hangs a PP the message is HUNG PP. 

In any case the packed date and time of the hang is placed in 
MB + 5. 



MTR FUNCTIONS TO CPUMTR 

These are special functions and the request is transmitted via 
the XO register instead of MTR's output register. 

(0) - RA REQUEST 

This function tells CPUMTR that some control point has an RA+1 
request. This is used for systems where the XJ is not available 
or the user's program is not doing an XJ. Upon entry XO is zero 
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ARTF (1) - ADVANCE RUNNING TIMES 

Update running times. Updates RTCL in CMR and ACTW in the 
control point area and sets time Limit exceeded flag if time 
Limit has been exceeded. It also checks for P equal to and 
program stop. CPUMTR checks the active control point and the 
instruction P points to. 



entry (XO) 



59 


17 





ARTF 



IARF (2) - INITIATE AUTORECALL 

MTR while in the routine PPL (process PP recalls) checks RA+1 of 
a control point in autorecall and if RA + 1 is set wi t h aut oreca 1 1 
requested, it reissues the PP request. 

If a PP routine who is called with autorecall finds that it 
cannot process the request it was called for at this time, it can 
copy its IR back to RA+1 if the control point is in R status. 
When MTR goes through its PPL routine it will find the request 
and have CPUMTR reissue it to a PP. 



59 



35 



23 



17 



entry (XO) 






cpa fwa 





IARF 



EPRF (3) '- ENTER PROGRAM MODE REQUEST 
entry (XO) 



59 




35 




23 


17 










pr 





MSTF 



pr Program mode request number as defined in 
COMSMTR 



MRAF (4) - MODIFY RA 

CPUMTR changes RA in STSW and the entry point by the specified 
amount. 



59 



47 



35 



17 







entry (XO) 



in/100 





cpa fwa 


MRAF 



in Value to change RA 
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MFLF (5) - MODIFY FL 

CPUMTR changes FL in STSW and the entry point by the specified 
amount . 



entry (XO) 



59 


47 




35 




17 







in/100 





cpa fwa 


MFLF 



SCSF (6) - SET (RESTORE) CPU STATUS 

CPUMTR places the specified status in the STSW word. This is used 
when MTR issues the DCPM function. The status is returned to MTR 
to be restored after the control point is storage moved. When 
MTR is ready to restart the CPU it issues this function restoring 
the former status. 

Functions EPRF, MRAF, and SCSF may all be used when a control 
point needs to have its FL changed via the RSTM function. If MTR 
has to move the control point it issues the DCPM and saves the 
status, then issues the EPRF for the move. If no storage move is 
required, then the MRAF is used. 

Finally, it issues SCSF to restore the former status. When a 
control point is going to be moved, the only criterion for that 
move is no PP activity, so the control point could be in any 
status when MTR is ready to make the move, and after the move, 
the proper status must be restored. 



entry (XO) 



59 


47 




35 




17 







status 





cpa fwa 


SCSF 



SMSF C7) - SET MONITOR STEP 

This allows CPUMTR to disable its automatic processing of monitor 
functions and to wait for MTR to indicate which function to 
process. SMSF and CMSF are used to set and clear the system STEP 
mode. Refer to DSRM. 



entry (XO) 



59 


17 





SMSF 
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CMSF (10) - CLEAR MONITOR STEP 

Reenables automatic processing of monitor functions. 

59 17 

entry (XO) 








ROLF (11) - SET ROLLOUT FLAG AND CHECK JOB ADVANCE 

This dual timing is used to set the rollout flag and check for 
job advancement. 

17 



59 



entry (XO) 








ACSM (12) - ADVANCE CPU JOB SWITCH 

Used to change the control point assignment of the CPU. It is 
used in the MTR routine JSW to process CPU job switching. This 
involves exchanging the CPU from one control point to another 
(slot time exceeded processing). 



entry (XO) 



59 


35 


17 





cpa fwa 


ACSM 



PCXF (13) - PROCESS CPU EXCHANGE REQUEST 

If CPUMTR is executing in one CPU and needs to be in the other 
CPU it will inform MTR via the CX words and XJ. MTR then issues 
this request to the other CPU. This is done in the AVC advance 
clock routine, which is the one section of MTR that must execute 
at least every 4 milliseconds. For example, consider function 
ABTM. PPR cannot distinguish which CPU its control point is in, 
so it starts CPUMTR up in CPO. If the control point to be aborted 
is in CP1, then CPUMTR must get itself into CP1 in order to get 
the control point out of CP1 . 

MTR processes pool PP OR requests as follows. 

If the CEJ/MEJ is available or is disabled, MTR checks all OR 
requests. If a request is for CPUMTR, MTR jumps to its CPR routi 
CPR exchanges in CPUMTR for that PP. 



ne 
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If the CEJ/MEJ is available, MTR ignores any CPUMTR request, 
since the PP must issue its own MXN; that is, CPO cannot stop 
CP1, so the PCXF alternate exchange request is made. 



59 



17 



entry (XO) 










PCXF 



ARMFC14) - ADVANCE RUNNING TIME AND MMF PROCESSING 
This function is called once every second by MTR to: 

• Status flag register bits 

• Write real-time clock to ECS 

• Read other mainframe clocks in ECS (every two seconds) 

59 35 23 17 

entry (XO) 






s 





ARMF 



MREF (15) - MODIFY ECS RA 

CPUMTR changes the ECS RA in ECSW and the exchange package by the 
amount specified. 



59 



47 



35 



23 



17 



entry (XO) 



in/1000 





CPA FWA 





MREF 



MFEF (16) - MODIFY ECS FL 

CPUMTR changes the ECS FL in ECSW and the exchange package by 
the amount specified. 

47 35 23 17 



59 



entry (XO) 



in/1000 





CPA FWA 





MFEF 
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CPUMTR STRUCTURE 

During deadstart, CPUMTR is loaded into CMR with the appropriate 
blocks for a particular environment- For instance, if ECS is 
available, the block of code pertaining to ECS is loaded; if 
mu It imainf rame has been selected, the associated MMF code is 
loaded. Since unnecessary blocks of code are not loaded, the size 
of CMR is optimally maintained. Optional blocks of code which 
might be loaded include the following. 



B lock Purpose 

CMU Move storage with compare/move unit 

(single CPU system, only) 
OCMU Move storage with registers (for 

non-CMU machines) 
CMUMTR Monitor mode CMU move 
OCMUMTR Monitor mode move storage with 

registers 
CP176 Code to process CYBER 170 Model 176 

hardwa re 
DCP Dual CPU operations 
MMF Mult imainf rame processing routines 
OMMF Processing routines without MMF 
SCP System control point facility 
SUBCP Subcontrol point processing 
UEC User ECS routines 
VMS Validate mass storage 
ECS ECS processing routines 
ECSBUF ECS buffer space 
MMFBUF MMF buffer space 
EXPACS Exchange packages 
CEJ Central exchange enabled 
XP176 Exchange packages for the CYBER 170 

Model 176 
OCEF CEJ disabled 
PRESET Preset CPUMTR (overlaid by PPU 

exchange packages) 



CPUMTR has the following structure. 

• MTR main program. Entry point from CPU program. 

• Utility subroutines 

• CPR - CPU program request processing. Requests are passed 
through RA+1 (refer to table 3-5). 

• PMN - MTR request processor (refer to MTR Functions to 
CPUMTR). 
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• PPR - PPU request processor (functions Listed Later in 
this sect ion) . 

• Program mode subroutines. 



• MNR - Monitor request processor. Program mode 
processors not initiated by PP functions. 

• Tab Les : 

TPMN PPU monitor requests 
TPPR PPU request tabLe 



MTR STRUCTURE 

MTR is Loaded into PPO at deadstart time and 
remains there for the duration of system execution. 

MTR performs the foLLowing functions: 

Processes certain PP requests 

ALLocates centraL memory and user ECS 

Maintains the reaL-time cLock 

Checks CRA+1) of active CPU programs for system requests 

Checks OR of each pooL PP 

Checks the SCR (CYBER 170) or ILR (CYBER 70 or 6000) for 
errors which require 1MB processing. 

STARTING MTR AT DEADSTART TIME 

MTR is Loaded in PPO. The first Location of the code is: 

TO CON PRS-1 

This forces the constant PRS-1 to faLL into TO. At the end of 
the Load, (P) is set to (T0)+1 which wiLL be (P)=PRS, the MTR 
preset routine. PRS presets aLL tabLes and constants. 

PRS overLays itself with tables and buffers. 

CPUMTR/MTR FLOWCHARTS 

Figures 3-5 through 3-22 flowchart the main routines used by MTR 
and CPUMTR. 
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*2 CCP 
check 
central 
program 




*1 This simulated Loop is a DUP statement in MTR code. 

*2 When MTR releases a channel, it sets a flag. At this time, 
the reservation byte in the channel table in CMR is cleared 



Figure 3-5. Main Loop for MTR 
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< ^ time to ^v 


no ^^X\me to^\ 


no 






\switch CPU/"^~ 




— s. uiibuk rr s- 

\. recall s^ 










yes 






yes 








' 


i 




w 








select 
new job 
(SNJ) 


check PP 
recall PPL 








w 












^ 




check 










program 
recall 










(x) status 










queue 














\ 


' 



ImtrJ 



Figure 3-6. Process Time Dependent Scanners 
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REAL-TIME CLOCK 

The real-time clock starts with power on and runs continuously. 
It may be read by any peripheral processor with an input to A 
(70) instruction from channel 14B. This channel is separate from 

the data channels. 

The clock period is 4096 (T0000B) mi c ro seconds. It is a 12-bit 
register that is advanced each microsecond from through 7777B. 
When it reaches 7777B, it starts over at 0. It must, therefore, 
be read at least every 4.096 milliseconds for accurate timing. 

TIME KEEPING 

MTR controls all time-keeping activities with routines TIM, AVC, 
and AVT. 

Routine TIM reads the real-time clock and updates RTCL (the 
central memory real-time clock). This routine must be entered 
at least once e\/ery millisecond. When one second has elapsed, 
the calls to AVT, ARTF, or'ARMF are enabled in routine AVC. 

Routine AVC has no time-keeping activity until one second has 
elapsed. The calls to AVT, ARMF, or ARTF are then enabled by 
TIM. 



Routine AVT advances the time of day and date in 
PDTL, TIML, and DTEL in CMR. 



words JDAL, 
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( AVC J 

Exit, unless time- 
keeping enabled 
by TIM detects 
one-second elapse 



advance 
second count 
and store in 
RTC1 



AVT 



\ 



read scan times / 
from MSCL / 



CPR 



(A) = ARTF 
V CAJ=ARMF(MME), 



CPR 



CPU 1 
(A) = ARTF 



read scan 
times from 
MSCL 



return 



*1 Advance CPU time. Accumu Lated control point time for 

active control point at CPU 0. 
*2 MSCL can be dynamically set from the console. ART reads it 

every second. 



Figure 3-7. AVC Advance Running Times 
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return 




SNJ 




yes 



read job 
control word 
(JCIW) 



read CPUO 
status from 
(ACPL) 




return 



read CPU1 
status from 
(ACPL + 1) 





yes 



*1 CPU active job CPU priority greater than this control point 
priority. 

*2 CPU 1 active job CPU priority greater than this control point 
priori ty . 



Figure 3-8. JSW - Process CPU Job Switching (CPU Slot Time) 
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Figure 3-9. PPL - Process PP Recalls 
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PP function requests are made to MTR by placing the function code 
in byte of the PP's OR. When the request is complete, MTR 
clears byte of the OR. 




read OSDs IR 
and set CP 
assignment 




indicate 
storage move 
in progress 



*© 



/ppr\ 



FNR 




*1 When DSD wants to do an action for a control point (such as 
n.XXX), it temporarily attaches itself to that control point 
by placing the control point number in its IR; it then makes 
the request. 

*2 If this control point is moving, the status must be set. 



Figure 3-10. DSD PP Function Request 



60454300 A 



3-29 



f PPR1J- 




set 

appropriate 

processor 




exit to 
proper processor . 

return from processor 
FNZ - if successful 
FN R - if unsuccessful 




*1 If request illegal, then effectively hang PP since OR is never 
cleared, this will not display PP hung at system PP. 



Figure 3-10. DSD PP Function Request (Continued) 
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If any of the functions requested desire an illegal operation 
(for example, DCHM drop channel wishes to drop a channel which 
does not exist) then it will jump to this routine. 



© 



set packed 
time and date 
in MB+6 



display 
message 
HUNG PP 



ir *1 



(TnjTJ 



*1 Do not clear OR and thereby hang this PP 



Figure 3-11- HNG - Hang PP and Display Message 
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© 



set 
request -» CM 



set CP number 
- FTNA + 1 



store MTR IR 



(CM CM + 4) 

-MTROR 



CPR 

request PP 

function 



Entry: (A) = function number 

(CM + 1, . . . , CM + 4) = parameters 
(CP) = CTR.pt. area address 

Exit: (cm, . . . , CM + 4) = response 

CM is FTN request word. 
CN is CPR request word. 




return 



3 



Figure 3-12. FTN - Process Monitor Function 
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check storagejmove status 




set error flag, 
clear CPU status 



advance 
CPU number 



MST 



process 
completion 




yes 



return 



The contents of the RA+1 for the control point at this CPU are 
checked and CPUMTR is requsted to process the request. The 
program address (P) is checked and if = 0, CPUMTR is requested. 

*1 Check active control point in CPU 0; then CPU 1 gets control 
point number in CPU 0. 

Figure 3-13. CCP - Check Central Program 
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read active 
CPU address 
(ACPL) 



get CP 
address and 
read CP 
status (STSW) 




system 
CP request 





' no 






no 


get RA + t 
from CP 




get RA + 1 
from 
subcontrol point 






















i 


' 




*1 A user control point is running; that is, this is not 

CPUMTR. 
*2 If CEJ/MEJ available, go to CCP1; if not, go to XJ1. 
*3 If (RA) = 0, this is CPUMTR and is ignored. 



Figure 3-13. CCP - Check Central Program (Continued) 
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/ccp\ 



request CPUMTR 

to process 

(RA + 1) request v 



clear request 
word^ CN, 
CN + 1,CN + 2 


i 


' 



request RA + 1 
check'-* CPR 



CPR 






no CEJ /MEJ option 



@ 



read program 
mode status 




yes 

ccp' 

3 J request is null 



check next CPU 



•1 No if (PX)=0; yes if (PX) nonzero. PX is defined in CPUMTR 
*2 Use PR defined in CPUMTR. 



Figure 3-13. CCP - Check Central Program (Continued) 
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f CPR J 



store request 
in CN + 4 



wait exchange 

package, (WXP), 

enter request 



store P = PMN (AO) 

(B0)^0 
in exchange package 







store (XO) = 
(CN, CN + 4) 



set exchange 
wait timer 




NIXN\ 




MXN 



set up MXN inst 
to correct CPU 



(A) * PPO 
(MTR) EPA 



MXN 

exchange to 

CPUMTR 



read P, AO, BO 
from PP EPA 




*1 This request wi I I be processed by CPUMTR at PMN. 

*2 PMN expects the request in XO. 

*3 If CEJ/MEJ option available, use code on this page 



Figure 3-14. CPR-CPUMTR Request Processor 
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Entry: (A) bits 0-11 - request 

12-17 = CPU number 
(CN r . . ., CN+2) * parameters 



^~Yno 

( MXN j*— — * 




yes 



have CPUMTR 
note exchange 
request 




yes 






check (MA) 


a' 


in PP EPA 


*1 








yes ' 


\ 










f *2 




no 


^/cpumtr\. 



completed 



yes 



return 



*1 Was this an RA+1 check. If no and exchange occurred, CPUMTR 
is now running and it will automatically process this 
request. If not, reissue the exchange. 

*2 There is a delay loop. 



Figure 3-14. CPR-CPUMTR Request Processor (Continued) 
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no 




set EXN insts. 
to reflect the 
correct CPU 



A = PP0 

exchange package 

address 



EXN - 
XCHG to 
CPUMTR 



check 
on CPUMTR 




read MTR/ 

CPUMTR 

interlock word 



I 



MTRL = 76B in CMR 



set (A) = exchange 

address 

from MTRL 



I 



EXN 
XCHG to 
new job 



return 



*1 When CPUMTR has completed, it places the exchange address of 
the control point to be started in MTRL and jumps to a 
one-word idle loop at CPSL = 77B in CMR, which is a zero 
word; that is, a PS. MTR is doing an RPN and waiting for 
CP) = CPSL. 



Figure 3-15. XCHG - The CPU with CEJ/MEJ Not Available 
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f MTRX X 



( MTRP J 

V 



MTRP entry: (X7) = reply word to be set 
into calling PPs 
output register 



copy reply 
into PPs OR 




MTRX entry: (B2) = 



XJ B2 

exchange to a 
control point 



address of exchange 
package for control 
point to be exchanged 
into CPU 



(imj 



exit: (P) = MTR 



Figure 3-16. CPUMTR Return Points 
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get RA from EP 
and read RA 



place control 
point in X 
status queue 



begin new job 




Entry: (AO) = CPU number (0 or 1) 

(B1) = 1 

(B2) = address of caller's EP 

(B7) = control point area address 



If CPn exchanged itself, then (B2) = (B7) 
and EP will be in CPA. If CPn was exchanged 
by MTR or some other pool PP, then (B2) = 
the address of the PP EPA which performed 
the exchange and (B7) = CPA. 



Figure 3-17. MTR - Exchange Entry From A CPU Program 
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read P (B2) 

= P in EP, 

set (X7) = 2 




© 



no 



Check for monitor request Is this exchange a CPUMTR 
EP or a CP EP. 



Process the RA + 1 request 



Exchange CP back in. CP wanted a short pause. 



Set error flag CPU detected on ARITH error. Uses 
(B7) = CPA, (X7) = error code. SEF will abort the 
CP program on ARITH error. 



Figure 3-17. MTR - Exchange Entry From A CPU Program (Continued) 
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PX is FWA of CPUMTR code and is the program mode exit 
request It is set when program mode portion of CPUMTR 
has determined that this CP job is complete. 



check special 
request for 
program mode 
monitor 
(PP request) 



read PR 
set (PX) = 




This is to determine if a CP or if the 
system CP (CPUMTR program mode) 
was interrupted. 



PR is a pointer to a stack of requests 
for program mode execution (that is, 
system CP queue). 



Let system CP continue running. 



ECP end central program. 

Uses (B7) = control point area address 
(XO) = status bits 
By setting (XO) - we set CP status = or not active. 



Figure 3-18. CHECK - For System CP Request 
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CPR 



Entry: (B3) = RA 

(B7) = CPA 

(X5) = (RA + 1) 

(A2) = address of RA in EP 

(A5) = RA + 1 



read subcontrol 
point status (SCPS) 
from bit 56 
ofSTSWinCPA 



H BCE begin control point executive 




process CPU call error 



Figure 3-19. Process - RA+1 Requests 
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*1 MXPF is maximum number a MTR request can be, so test is (XO) 
- MXPF > 0, then go to PMN2. 

*2 Those processors which require program mode CPUMTR will exit 
via EPR. EPR will check to see if the system control point 
was interrupted for this request and if so, will exit to 
MTRX. If control point n was interrupted, then it will 
exit to BCP1, which will place this now deactivated control 
point into W status, and then exit to MTRX. 



Figure 3-20. PMN - Exchange Entry From MTR 
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read OR 




i 


' 




unpack 
request 


/'pprN 






^0/ 


' 


V *1 




select 

appropriate 

processor 



clear PP 
exchange 
request 
status 



Entry: (A5) = address of calling PPs OR 
(B2) = address of calling PPs EP 



Cexit to proper ^v 
processor J 



Each processor will exit: 

to MTRP with reply word in (X7) 

for PPUs OR if necessary, 

-OR- 

if no reply word necessary, then 
exit to MTRX. 



If the processor requires program mode CPUMTR, the macro PPR will 
generate a queue entry and set up the exchange package, then 
jumps to PRG, sees no request, and jumps to PR61 . 

*1 Check to see if request (which is a number) is larger than 

the maximum. 
*2 Hang PP by not clearing OR, and display message PP HUNG at 

system control point. 



Figure 3-21. PPR - Exchange Entry for Pool PPs 
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set request 
exit PX = 1 



XJ 




get request 
word PR 



no 




CPUMTR starts the program mode portion 
at PRG in program mode. This is the 
standard exit for program mode CPUMTR. 



Exchange to CPUMTR in monitor mode. This 
will force (P) = PRG in EP in the system CP 
CPA, so that the next time CPUMTR starts up 
the system CP, execution in program mode 
will begin at PRG. 




no, hence, it is a PP request. 



select 

appropriate 

processor 



exit to 

proper 

processor 



Figure 3-22 



PRG - Exchange Entry for System CP (Program Mode 
CPUMTR) 
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IDL, IDL1 - CPUO AND CPU1 IDLE LOOPS 

The exchange package for IDL is Loaded at the end of CPUMTR 
IDL1 and its exchange package are located in the dual CPU block 



(P) * -2 - 

(RA) = location of IDL in CPUMTR 

(FL) = 5 

(MA) = location of this EP 

(EM) = 7007 

all other register =? 



(P) = 2 

(RA) = location of IDL1 in CPUMTR 

DCP b lock 
(FL) = 5 

(MA) - location of this EP 
(EM) = 7007 



all other register = 



P rogram IDL 
0000 IDL CON 



0001 



CON 



P r ogr am I DL1 

(RA) for idle IDL1 CON 
rou t i nes 



(RA+1*0) for 
idle rout i ne 



CON 



0002 



EQ 



neve r any 
request s 

j ump to itself 



EQ 



Program IDL and IDL1 runs until a PP or MTR interrupts them and 
exchanges CPUMTR into the CPU. If CPUMTR finds no other jobs to 
run, it exchanges IDL or IDL1 back into the CPU. 



CPUMTR SEGMENTATION 

A significant amount of code is required in CPUMTR to support a 
mu It imainf rame environment which is not needed by sites not 
utilizing this feature. Since CPUMTR resides in central memory, 
it is desirable to provide a mechanism whereby code associated 
with a particular feature (in this case mu It i ma inf rame) may be 
optionally loaded or discarded at system deadstart time. 
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CPUMTR accomodates blocks of code that may be optionally loaded. 
These blocks of code are placed into labeled common by USE cards. 
Blocks come in two types. One type always requires the presence 
of an associated block and one of the two blocks will always be 
loaded. The other type of block has no associated block and with 
either be loaded or discarded by CPUMLD. For example, if OMMF is 
the name of an associated block which is loaded when MMF 
processing is desired, then OMMF is loaded in its place if MMF 
processing is not desired. The convention therefore is to place 
a zero in front of the block name for the option-not-present 
block. Any given feature may have as many blocks associated with 
it as is necessary with any number of them being loaded. 

A CPU program, CPUMLD, loads the desired CPUMTR blocks. CPUMLD 
is a simple relocating loader which reads in and loads the 
segments required to utilize any optional feature selected during 
the pre-deads tart process. This covers the case of wanting one 
set of code for environment A and another set for environment B. 
STL Loads CPUMLD and CPUMLD issues requests to STL to read in 
CPUMTR from the deadstart tape. 



EXCHANGE JUMPS 



An installation may make use of the optional hardware 
instructions MXN (monitor exchange) and XJ (exchange jump) or 
(exchange). NOS requires either the combination of MXN/XJ or 
EXN. 



EXN 



Exchange jumps use an exchange package (refer to section 2). 

CENTRAL PROCESSOR MONITOR 

System functions are normally handled by the monitor located in a 
peripheral processor. The CYBER 170/70 computer systems are 
equipped with certain hardware capabilities to effectively 
implement monitor activities in the central processor. Since the 
central processor can reference extended core storage directly 
for service routines, programs, and data, a central processor 
monitor program to handle these and other functions is faster and 
more efficient than a monitor residing in a peripheral processor. 
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The hardware elements of the CYBER 170/70 system which provide 
the essential capabilities f o r i mp lement i ng a central processor 
monitor are described in the f ol lowi ng pa ragraphs . 



Monitor Address Register (MA) 

Contained in the exchange jump package (bits 53 through 36 of 
word 6) is an 18-bit monitor address. Just as other central 
processor operational registers are loaded during an exchange 
operation, so is the monitor address register loaded with the 
18-bit monitor address. This monitor address is the starting 
address of the ex change package for an ensuing central exchange 
jump instruction (except when the monitor flag bit is set). 

Monitor Flag Bit 

The central processor has, in the central memory control section, 
a monitor flag bit. A master clear (deadstart) clears the 
monitor flag bit. Any action thereafter on this bit is via the 
monitor exchange or the central exchange jump instructions. 
(There is no instruction with which to sample the status of this 
bit directly and/or independently of these instructions.) 



Mode 



Monitor mode 



Program mode 



F lag Bi t 



CPU 



Not i nte rruptab le 
Interruptable 



Central and Monitor Exchange Jump Instructions 

With the CEJ/MEJ option two instructions exist for central 
processor monitor implementation. The first, XJ, is executable 
by the central processor and the second, MXN, is executable by 
t he peri phera I processors. These instructions are as detailed in 
the COMPASS Reference Manual. 

The XJ instruction unconditionally exchange jumps the central 
processor, regardless of the state of the monitor flag bit. The 
instruction action differs, however, depending on whether the 
monitor flag is set or clear. Operation is as follows: 

• Monitor flag bit clear 

The starting address for the exchange is taken from the 
18-bit monitor address register. This starting address is 
an absolute address. During the exchange, the monitor 
flag bit is set (MF=1) 

• Moni tor f lag bi t set 

The starting address for the exchange is the 18-bit 
result formed by adding K to the content of register Bj . 
This starting address is an absolute address. During the 
exchange, the monitor flag is cleared. 
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The MXN instruction, typically used to initiate central processor 
monitor activity, is a conditional exchange jump to the central 
processor. If the monitor flag bit is set, this instruction acts 
as a pass instruction. The starting address for this exchange is 
the 18-bit address held in the peripheral processor A register. 
(The peripheral processor program must have loaded A with an 
appropriate address prior to executing this instruction.) This 
starting address is an absolute address. 



In an i ns t a I lat i on wi t hout the MXN/XJ instruction set, the EXN is 
the only exchange instruction available. It is a PP initiated 
exchange jump which occurs independently of the mode of the CPU 
and has no effect on the CPU mode. MTR is the only PP program 
that may perform an EXN; it must simulate the MXN for all PPs in 
the system and simulate XJ for the central processor, 
detects a request for CPUMTR in a PP output register, 
to the exchange package for the pool PP which desires 
exchange jump. 



When MTR 
it will EXN 
the 



NOTE 



PP memory instruction layout is 
as MXN. 



the same 



Programming Notes 

Any exchange to the exchange package loads the 
contents of word 6 into the. monitor address 
register (other operational registers are similarly 
loaded). Thus, any ensuing XJj instruction using the 
contents of the monitor address register as a 
starting address uses those contents as loaded. 

The exchange packages for entering the central processor monitor 
should usually have the reference address (RA) equal to 000000 
and the field length equal to central memory size. 

Since the monitor flag bit cannot be directly sampled, a program 
cannot directly determine its state; hence, success in performing 
a peripheral processor monitor exchange cannot readily be 
predicted. Further, program control always is given to the next 
instruction, whether or not the exchange is honored. 

Table 3-6 summarizes the operational differences between the 
normal exchange jump instruction EXN and the monitor and central 
exchange jump, MXN and XJ. 
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TABLE 3-6. EXCHANGE INSTRUCTION DIFFERENCE 



No 

CEJ / 
MEJ 



With 
CEJ / 
MEJ 



| | | Operational Differences I 


| | | Effect I FWA of 1 
j j |on |Exchange I 
j | Condi ti anal/ | Monitor |Package I 
(Instruction 1 Uncondi t iona I | F lag .Bi t | i n CM I 


j EXN | Uncondi t i ona I I No effect on | Pe r i phe r a I | 
1260 (normal | I f Lag Iprocessor I 
Iperipheral II l A register I 
Iprocessor | 1 1 1 
| ex ch ange 1 1 1 ' 1 
I j ump) 1 III 


JMXN (Conditional |Sets flag jperipheral I 
|261 |'(occurs only | Iprocessor I 
((peripheral |if monitor I I A register | 
Iprocessor t f L a g bit is I I I 
Imonitor Iclear; passesi I I 
I exchange | i f f lag i s I I I 
| j ump) | set ) I I I 


J x J | tin conditionaljsets flag ICentral I 
|013(central| 'I Iprocessor I 
| exchange | I I moni tor | 
I j ump) wi th I I I address I 
Imonitor flag I I (register | 
I bi t c lear I I I ' 


j x J K+(Bj) j Uncondi t ional | C lears flag |Address I 
|013 j | |formed by I 
| (central | I |K+(Bj) I 
lexchange ( I I I 
Ijump) with I I I I 
| moni to r f lag | I I I 
I bi t set I II I 



To determine whether the MXN took place: 
1 . 



Set BO (bits 0-17 of word 0) in the exchange package to 
7777. 

Initiate the monitor exchange (261). 

Read BO from the exchange package in central memory. If 
the monitor exchange was honored, BO in the exchange 
package will equal 000000. If the instruction passed, 
this location still holds 7777. 
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Different exchange packages should be used for central processor 
exchanges and peripheral processor exchanges. This aids software 
determination of which of two jumps (central or monitor exchange) 
was executed when both were initiated at approximately the same 
time. 

Simultaneous exchange requests are resolved in favor of the 
central processor. 

The state of the monitor flag bit has no effect on the operation 
of the normal PP exchange jump (260); nor has this instruction 
any effect on the flag. 

In addition, there may be CPUMTR requests which require more CPU 
time than it is feasible for CPUMTR to use in monitor mode and 
still ensure smooth system flow. For these requests/, such as 
DTKM (drop tracks), CPUMTR will queue them at the system control 
point and exchange jump to this control point. The system 
control point operates in program mode and is treated as any 
other user program. If the system control point is interrupted 
with another long request, the request is placed in the system 
control point queue and the system control point is restarted. 
The system control point can be interrupted by any MXN from a PP. 
However, because its CPU priority is the highest in the system 
(100), it will always get the CPU back immediately. No other 
control point will get the CPU if the system control points wants 
i t . 

Table 3-7 shows the correspondence between a control point, 
control point address, and the exchange package MA for a system 
configured to have 17B control points. 

Table 3-8 shows all the system exchange packages and the entry 
points into CPUMTR. 

A control point will always have (MA) equal to its exchange 
package address. Additional exchange packages are provided for 
the two idle routines, subcontrol points, disabled central 
exchange, return package, disabled central exchange program, and 
a simulated exchange exit to monitor mode. These packages are 
generated at the end of the CPUMTR code. PPO, MTR's exchange 
package, is not contiguous with the other PP exchange packages. 
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FLOW OF EXCHANGES 

The flow of exchanges are -i L Lust rated and explained in Figures 
3-2.5. through 3-28. The four types of exchanges are: 



• Pool PP 

• MTR 

• Control point program 

• System control point 



TABLE 3-7. CONTROL PO INT / EX CHANGE PA CK AGE 
CORRESPONDENCE 



| Cont ro I 


Pa i n t I 


Addres s | 


Exchange Package MA 




1 1 - . 




200 | 


200 


| 2 .... • 




400 I 


400 


I .3 .. 




600 I 


600 


I 4 ■ . 




1000 


1000 


I 5 \ 




1200 


1200 


I 6 




1 400 


■1400 


| 7 




1600 


1600 


I 10 




2000 


2000 


| 11 




2200 


2200 


I 12 




2400 


2400 


I 13 




2600 


2600 


I 14 




! 3000 


3000 


I 15 




I 3200 


3200 


| 16 




I 3400 


3400 


I 17 




| 3600 


| 3600 


| 20 (S 


y s t em) 


| 4000 


| 4000 
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TABLE 3-8 



SYSTEM EXCHANGE PACKAGES 



| 1 | I ISubcontrol 
| | IControl" IControl |Poi'nts and 
I JPPU iPoint iPoints jldle 
[PPUs*2 [Monitor |n+1 |1 thru n |Programs 


111 | ISCX Sub CP 
I I I I I E P 1 

|PXP PPU |MXP PPU [ SXP System |200B Control |SCX1 Sub 
I (PP2) JMonitor IControl Pointjpoint 1 |CP EP2 
[Exchange lExchange |n+1 Exchange [Exchange | 
[Package IPackage (Package [Package | 
I | CPPO) | | | 
I • I I I • I 
Graphic! • I I I • I IXP IDLE 
Repre- I • I | | • | CPUO 
senta- III I I 
t ion | | | I I 

(PPUCPPn) | | |n*200B Cont ro I | IXP1 IDLE 
x [Exchange | j jPoint n j CPU1 
[Package | | lExchange | 
I I I IPackage | 


Signi- |P=PPR |P=PMN |P=PRG |P=CP Prog [Sub CP P- 
ficant |MA=zero |MA=zero |MA=System |P address |MTR 
Content | B2=address j B2=MXP [ Control |MA=This |MA=SCX 
jof PPi EP j | Point | Control | SCX1 
|CPXP+(i-2)| | Area j Point |B2=SCX, 
|*21B) | | Address | Area | SCX1 
j | j =SXP j Address | I DLE P= 
| | | | =addr. of idle 
| | | | CPi XJPKG |Loop addr. 
| j | j Ci*200BD | (IDL,IDL1 ) 
III I |MA=IXP, 
I I I I I IXP1 


Size, [21 words |20 words | First 20 of |First 20 words|20 words 
Numberslper pkg. |for this Isystem Jof each |for each 
and | Up to 18 Ipkg.This [control poi nt | cont ro I point Ipackage. 
Loca- | pkgs .These | i s at thelarea in CMR |area in CMR | 
tion jstart at lend of | I I 
I end of ICPUMTR | | I 
ICPUMTR jj j i 
I code* || | I 


Symbol- | CPUMTR ICPUMTR ICPUMTR |200B ICPUMTR 
ic laddress [address laddress |400B laddress 
addresslPXP JMXP j SXP | . |SCX and 
I I I I | IXP 
I || j | S CX1 IXP1 
I j j |n*200B | 



* The 21B words spaces the packages so that no bank conflicts 
will arise when PPs access them. 
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In figure 3-23, assume the CPU is active with control point n and 
monitor flag zero. If monitor flag is equal to 1, then the 
exchange does not take place. PPn builds a CPUMTR exchange 
package in its exchange package area. 

Note 

CPUMTR will exit to MTRX by executing an XJ B2. 
MTR follows MTRX; therefore, after the 
exchange (P)=MTR in the CPUMTR and exchange 
package in the PPn exchange package area. 

Figure 3-24 is the same as the pool PP request except that 
(P)=PMN and CXQ) equals the request in the MTR exchange package 
area. 

In figure 3-25, control p o int n is running in the CPU (monitor 
flag zero), the monitor address is the address of control point 
n, and the control point address equals the exchange package 
first word address. 

Figure 3-26, is the system control point program mode. 

Note 

The system control point can be interrupted by 
a PP program. In this case the PPn exchange 
package area contains the system control point 
, exchange package of which (P) equals the 
address of the next instruction to execute (not 
PRG) . 

Table 3-9 illustrates the relationships of the monitors, pool 

PPs, and control points.- . 
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TABLE 3-9. MONITOR, POOL PP, CONTROL POINT RELATIONSHIPS 



Type | | | |Reason |Location| 
of |lnitiated| |Request| for | of | Final 
Exchangel by |Action | to IRequest IRequest |Disposition 




Control IControl IRequest ICPUMTR |Needs |RA+1 |CPUMTR/PP 
Point |Point | | |help | | 
I Prog rami | | | | 


System (Program IRequest ICPUMTR |Needs |PX ICPUMTR/PP 
Control |Mode | | (action | | 
Point JCPUMTR | | jfrom j j 
j | | JCPUMTR | j 


Pool PP |Pool PPs/ IRequest ■ | CPUMTR INeeds | OR |CPUMTR/PP 
and MTR |MTR | j |help or | | 

I I I I i nter- I | 

II I I lock | | 
I | | | f un ct i on | | 
I I I 135-71. | | 


Pool PP |Pool PPs IRequest | MTR |Needs |0R |MTR 
and MTR | | | | he Ip or | | 
I I I | i nt er- | | 
I III lock | | 
I | | | f unct i on | | 
I I I M-34. | | 


MTR |MTR |Special | CPUMTR |Needs | XO in EP|CPUMTR 
I | Request | | he Ip I I 
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CPAn 

CPUMTR 

EP 
(P)=MTR. 



PPn EPA 



Same as above, 
no change 



Same as above, 
no change 




CPUMTR 


EP 


(P)-PPR 


(B2)=EPA FWA 





CPn 




EP 




Addrs of 


(P) 


= Next Inst. 



CPUMTR 

EP 
(P)=MTR 



1. PP sets word zero of exchange package. (P)=PPR, (B0)^0 
(B2)=EP address for the PP issuing MXN. 

2. CPUMTR starts executing at PPR. When complete, it issues 
XJ B2. 

3. (P)=MTR since this Location follows MTRX in CPUMTR. The 
next time this PP calls CPUMTR, it will reset (P)=PPR. 



Figure 3-23. Pool PP Request 
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CPAn 

CPUMTR 

EP 
(P)=MTR 



Same as above, 
no change 



Same as above, 
no change 




MTR EP 

CPUMTR 

EP 
(P)=PMN 
(B2HMTR EPA FWA 
(XO)=request 



CPn 

EP 

Addrs of (P)= 

next instr. 



CPUMTR 

EP 
(P)=MTR 



1. MTR sets up P, BO, B2 . The request is stored in (XO) and 
the MTR issues MXN. 

2. CPUMTR starts executing at PMN and exits at MTRX. 

3. Same as pool PP. 



Figure 3-24. PP MTR 
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CPAn 

CPUMTR 

EP 

(P)-MTR 

(B2)-EP FWA 



CPn EP 

(P)=addr of 

next in$tr. 

(MA)-EP FWA 



CPUMTR 

EP 

(PHMTR 

(B2HEP FWA 




1. Control point n places the request in RA+1 , and will either 
XJ(MA) (where MA is the hardware register in the CPU), or 
wait for MTR to notice the request. 

2. CPUMTR processes the RA+1 request and (unless recall is 
requested) reactivates control point n by XJ B2. (Note: 
(B2)=EP FWA) 

3. CPUMTR exits at MTRX which sets (P)*MTR in control point n 
control point area. 



Figure 3-25. Program Request 
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CPAn+1 



SYS CP EP 
(P)=PRG 
(MA)=SYS EP FWA 



CPUMTR 

EP 
(P)= MTR 
(B2)=EP FWA 



SYS CP EP 
(P)=addr of 
next instr. 
(PRG) 
(MA)=SYS EP FWA 




MF=0 



CPn EP 

CPn EP 

(P)=addr of 

next inst. 

(MA)=EP FWA 

for CPn 



Same as above, 
no change 



Same as above, 
no change 



CPn EP 



CPUMTR EP 
(PhMTR 
(B2HEP FWA 
for CPn 



1 . 



3. 

4. 



CPUMTR will add this request to the system control point 

queue. It then exits to MTRX (which is an XJ), thereby 

setting (P)=MTR in the exchange package. 

When the system control point has exhausted its queue, it 

will XJ (MA) back to CPUMTR. 

System control point has finished and exchanges to CPUMTR. 

CPUMTR will now start the highest priority control point n 



Figure 3-26. System CP Program Mode 
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A probable sequence of system interaction is illustrated and 
explained in figures 3-27 through 3-37. 

In figure 3-27, assume CPUMTR is running in MM, and it decides to 
activate control point 12; that is, give the CPU to control point 
12. 



CP12 CPA 




PTX CPUMTR EP in CPU 
(MA)»2400 

CPUMTR issues 
XJ B2 (B2-2400) 

ATX CP12 EP in CPU 

CPUMTR EP in CP12 EPA 



Figure 3-27. CPUMTR Running in MM Activates CP12 
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Figure 3-28 assumes that PP3 asks CPUMTR to perform a function. 
PP3 must build a CPUMTR exchange package in exchange package area 
PP3. Note that RA is 0, FL equals machine field length, and P 
equals PPR, the FWA of CPUMTR PP function processor. PP3 issues 
an MXN. Since MF is 0, this exchange will occur. 



PP3 EPA 




2400 



CPUMTR 
EP 



2400 



CPUMTR 
EP 



PTX CP12 EP in CPU 
PP3 issues MXN 
ATX CPUMTR has CPU 



Figure 3-28. PP3 Requesting Function from CPUMTR 
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In Figure 3-29, CPUMTR processes the PP request and then 
determines from CPU priori ties that control point 14 should be 
act i vated . 

Note 

Control point area 14 may exist from a previous 
XJ by MIR or may have been built due to a 
request by the scheduler or the advancement 
routines. Since control point 12 will not be 
activated, it is necessary for CPUMTR to move 
control point 12 from the PP3 exchange package 
area to the control point 12 exchange package 
area before issuing XJ=3000. 



PTX 



PP3 



CP12 
(MA)=CP12 
CPA FWA 
(2400) 



CP12 



©2400 



CPUMTR 



3000 



CP14 



CPU EP 



Copy to 

CP12 

EP 



ATX 



PP3 EP 



CP12 EP 
(MA)»2400 



Restore 
PP3 EP 
(MA)-O 



Restore 
PP3 EP 
(MA)«0 



Copy PP3 EPA to CP12 EPA 



CPU 



MF»1 ( CPUMTR J 



CP12 EP 



3000 



CP14 EP 



CPU 



CP12 EP 




CPU EP 



CPUMTR EP 



Figure 3-29 



CPUMTR Processing PP Request Activates Control 
Poi nt 1 4 
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In figure 3-30, MTR decides to switch control points (that is, 

stop control point 14 and start control point 10) and issues an 

ACSF (switch job request) to the CPUMTR. MTR must build a CPUMTR 

exchange package in its exchange package area and issue MXN. 



PTX 



MTR EPA 



CPUMTR 
EP 



ATX 




3000 



CP14 EP 



CPUMTR 
EP 



CP14 running in CPU 



3000 



Same as above, 
no change 



CPUMTR in CPU 



Figure 3-30. MTR Switches Control Points 
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In figure 3-31 CPUMTR activates control point 10. MTR decides 
which control point to start, and CPUMTR starts it. 



PTX 



MTR EPA 


MF-1 


j CPUMTR J 


2000 


CP10 CPA 


3000 


CP14 CPA 


CP14 EP 
(MA)=CP14 

CPA 
FWA=3000 


CP10 
EP 


CPUMTR 
EP 







Same as above, 
no change 



Restored 

MTR EP 

(MA)-O 



ATX 



Same as above, 
no change 




MF=1 



MF=1 



MF=0 



Same as above, 
no change 



Same as above, 
no change 




Same as above, 
no change 



3000 



Same as above, 
no change 



Figure 3-31 . CPUMTR Activates Control Point 10 
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In figure 3-32 control point 10 needs to call CIO. It places the 
call in RA+1 and issues an XJ. Since the monitor flag is zero, 
the exchange will store the CPU exchange package value in 
location (MA). Now, whenever CPUMTR builds the control point 10 
exchange package, it sets (MA)=2000 and (P)=MTR, the FWA of 
CPUMTR control point request processor. 



2000 




CP10 CPA 






CPUMTR 
EP 








RA + 1 


CIOP 


7/A 


FET address 













ATX 



CP10 
EP 



RA+1 



O 



Figure 3-32. Control Point 10 Calls CIO 

CPUMTR places control point 10 into autorecall, calls CIO to a 
pool processor (for example, PP6), and searches for the highest 
CPU priority job to activate which is control point 16 (figure 
3-33) . 



CP16 CPA 



PTX 



ATX 



( CPUMTR J 



( CP16 J 



2000 



MF=1 



MF=0 



Same as above, 
no change 



3400 




CP16 
EP 



CPUMTR XJ 
B2=3400 



Same as above, 
no change 



CPUMTR 
EP 



Figure 3-33. CPUMTR Calls CIO, Activates Control Point 16 
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CIO runs to completion, sets the status of its operation to 
complete, and prepares to drop. In order to ; drop, CIO will MXN 
to monitor with a DPPM (drop PP request). Refer to figure 3-34. 



PP6 EPA 



CP16 CPA 



PTX 



ATX 



EPA FWA 


CPUMTR 
EP 
(B2)-PP6 EPA 
FWA 








CP16 
EP 












CPUMTR 

EP 
(B2)-PP6 
EPA FWA 




3400 



CPUMTR 
EP 



3400 



oame as above, 
no change 



CPUMTR takes CP10 
out of auto-recall and 
makes it a candidate 
for the CPU. 



CPUMTR XJ B2 
(-addr of PP6 EPA) 



Interrupted CP16 
continues. 



Figure 3-34. CIO Runs to Completion and MXNs to Monitor 
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In figure 3-35 PP4 issues a DTKM (drop track function) via an 
MXN. 



PP4 EPA 



CP16 CPA 



PTX 



EPA FWA 



CPUMTR 
EP 
(B2HPP4 EPA 
FWA 



ATX 



CP16 

EP 

(MA)-CP16 

CPA 
FWA (3400) 




3400 



CPUMTR 
EP 



3400 



Same as above, 
no change 



Figure 3-35. PP4 Issues DTKM Via MXN 
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Now PP4 idles on its OR until monitor satisfies its request. 
DTKM is a request which takes too long a CPU time-slice; 
therefore, it is processed by CPUMTR in program mode via the 
system control point- The system control point is treated as 
other control point except that it has the highest priority. 
CPUMTR begins processing this request by queuing the request 
executing XJ 82=4000, thereby activating the system control 
point. If the system control point is interrupted, CPU/MTR 
processes the interrupting request. 



any 
and 



If it is a request which is also processed by the system control 
point, CPUMTR queue, this request and reactivates the system 
control point. In this way, all these types of requests are 
handled in a first come, first served order. 

Before the exchange can occur, however, CPUMTR must copy the 
control point 16 exchange package from PP4 exchange package area 

as shown in figure 3-36, 



PTX 



PP4 EPA 



CP16 

CP 

(MA)=CP16 

CPA FWA 

(3400) 



CP16 CPA 



MF=1 



f CPUMTR J 



System CPA 



CPUMTR 
EP 



4000 



SYS 

EP 

(P)-PRG 



ATX 




Same as above, 
no change 


MF=1 
MF=1 


I CPUMTR J 
I CPUMTR J 


3400 


CP16 
EP 


4000 


Same as above, 
no change 














Restored 
PP4 EP 
(MA^O 


3400 


Same as above, 
no change 


4000 


Same as above, 
no change 



Same as above, 
no change 



MF=0 



( SYS \ 



3400 



Same as above, 
no change 




CPUMTR 

EP 
(P)-MTR 



Figure 3-36. System Control Point Processing 
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When the system control point completes all the requests in its 
queue, it will XJ (MA) to the CPUMTR. 

For system control point (MA)=400Q, CPUMTR sets (P)=MTR in the 
CPUMTR exchange package at system control point area. When the 
system control point exchanges, CPUMTR begins at MTR. However, 
the system control point begins executing at PR6 (figure 3-37). 



PTX 4000 


CPUMTR 

EP 
(P)=MTR 








SYS CPA 


ATX 4000 


SYS 

EP 
(P)=PRG 








Figure 3-37. System Control Point XJ (MA) to CPUMTR 
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SUBCONTROL POINTS (SCP) 



Subcontrol points are divisions of a central memory control 
point. A user can set up a control point to contain two or more 
programs; one of these is designated as the executive, and 
monitors the other programCs) or subcontrol points. 



The execu 
manner t h 
a cont rol 
o r makes 
Simi larly 
exceeds i 
back to t 
point so 
subcont ro 
outside i 
ac cess by 
Ft def i ne 
and contr 



t i ve 

at t 

poi 

an e 

, w h 

ts t 

he e 

that 

I po 

ts b 

the 

the 

o I a 



controls its subcontrol points in much the same 
he system monitor controls the control points. When 
nt makes a system request or exceeds its time limit 
rror, control is given back to the system monitor, 
en a subcontrol point makes a system request or 
ime Limit or makes a CPU error, control is given 
xecutive. The executive sets up each subcontrol 
, within the field length of the control point, each 
int has its own RA and field length and cannot go 
oundaries. The executive is thus protected from 
subcontrol points, whereas the executive's RA and 
full control point so the executive can watch over 
11 subcontrol points within the field length. 



The subcontrol point concept depends on the executive program's 
handling of the subcontrol points. This involves starting, 
stopping, error processing, and other functions similar to those 
of the system monitor. 

Just as the system monitor keeps track of each control point 
through its exchange package, the executive can control the 
subcontrol points through their exchange packages. 



It is th 
package 
have the 
These ex 
execut i v 
length o 
subcont r 
i ndi cat i 
subcont r 
request, 
point de 
request . 
'showing' 
active . 



e re 
for 

app 
chan 
e ' s 
f th 
ol p 
ng t 
ol p 

it 

sc ri 

CP 

that 

Once 



spons 
each 
ropr i 
ge pa 
field 
e s u b 
oi nt, 
he ad 
oi nt 
termi 
bed i 
UMTR 
at t 
act i 



ibility of the executive to set up an exchange 
subcontrol point; each exchange package must 
ate RA, FL, and so on, for the subcont rol point, 
ckages must be set up somewhere within the 

length, but probably not within the field 
control point. To start execution of a 

the executive uses an XJP RA+1 request 
dress of the exchange package area of the 
to be activated. When CPUMTR picks up the 
nates the executive and activates the subcontrol 
n the exchange package area indicated on the XJP 
also sets a flag in the control point area 
his control point a subcontrol point is now 
vated a subcontrol point runs until: 



1 . It makes a CPU error 

2. It exceeds its time limit 

3. It makes an RA+1 request 
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Under any of these three conditions, control is given back to the 
execut i ve . 

The executive can thus monitor error processing for the 
subcontrol points. Errors can be noted and examined without 
termination of the control point. Upon returning control to the 
executive, certain information is set up in the X registers: 

(X2) = msec before this subcontrol point began 

(X6) = error flag (12 bits) and RA of this subcontrol point 

CX7) = msec used by this subcontrol point 

One of the parameters on the XJP request is the time for the 
subcontrol point. When this time limit is passed, control goes 
back to the executive. 

When a subcontrol point makes an RA+1 request, control is 
returned to the executive; the executive can then decide whether 
t o : 

1 . Ignore the request 

2. Handle the request itself 

3. Pass the request on to CPUMTR using RA+1 of the control 
poi nt (execut i ve) 

Subcontrol points can be set up by any CPU programmer using any 
programming language; some features are only usable by COMPASS 
programs. The structure of the executive is flexible within the 
limits we have discussed so far. As an example, consider the 
transaction subsystem using subcontrol points. 

TRANSACTION EXECUTIVE 

The transaction executive is designed to let many different users 
use one system; each user needs transaction processing. Users 
can set up their own programs for transaction processing and all 
transactions can be handled through the transaction executive. 

The transaction executive uses subcontrol points so that it can 
maintain complete control over each task to be performed. Within 
its field length is needed a protected area for the executive; 
the remaining field length can be used by up to 31 subcontrol 
points. The tasks to be performed require different programs 
that do not need to be in memory simultaneously; rather than 
using traditional overlays which have no protected area for the 
executive, each task or transaction program can be set up as a 
subcontrol point which can be activated as necessary by the 
executive. 
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Transaction programs can be written in any programming language. 
In order to make the programs more useful, the first 100 words of 
each program should be aLLocated for communication between 
subcontrol points; this can be done by using labeled common which 
is always at the beginning of the field length, for example: 

(FTN) COMMON /CC0MM0N/ A(100) 

(COMPASS) USE /CC0MM0N/ 



BSS 



100 



(COBOL) COMMON STORAGE SECTION. 

77 A OCCURS 100 TIMES. 

NOTE 

RA+0 through RA+100 is normally not easily 
available to higher level languages, therefore 
the technique of labeled common allows, an easy 
method of access to RA+101 through RA+201 . 

The user programs should be compi led and then loaded to create a 
(0,0) overlay from each transaction program. 

Each transaction to be processed must give enough information to 
indicate the proper transaction program to be brought in for 
processing. This information could include: 



1 



User's name (code) 



2. Type of transaction 

3. Data to be used in the transaction 
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ram as a subcontrol 
ute (0,0) overlay the 
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ransaction requires 
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* LDR always gives control directly to the (0,0) overlay after 
loading; this does not allow the executive to start the 
subcont rol poi nt . 
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The transaction executive's job sets up the field Length in the 
most efficient way. The field length must contain: 

• The executive's code 

•Tables 

I 

• Subcontrol points 

• Exchange package areas for each subcontrol point 
The field length could be set up as shown in figure 3-38. 



RA 



RA SCP1 -100 



RA 



FL 



SCP1 



SCP1 



RA SCp2 -100 



RA 



SCP2 



FL 



SCP2 



executive 



tables 



V////////////////////////////////////^7? / 



RA SCP3- 100 



y///////////////////////////////////////m7 / 



RA 



SCP3 



FL 



SCP3 



free FL to aid 
in storage moves 
by the exective 



FL 



T 



4, 



Figure 3-38. Subcontrol Point Field Length 
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The area RA scp -100 through RA scp can be used for the exchange 

package area for the subcontrol point. The executive can fill in 
this area as it reads in the program; it gets P from the 50 table 

of the (0,0) overlay binary, it can set up values for the 

registers for COMPASS programs, it sets up RA and FL depending on 

where the program was read into memory and how many words were 
read i n. 

The executive always checks through its tables to see if the 
program is already at a subcontrol point; if it is already at a 
subcontrol point, the executive checks to see if it is a reusable 
program if the program is not in memory or not reusable, the 
executive will read in another copy of it. The executive looks 
for the next available place inmemory to put the program and 
brings it in using READR (READSKP) and updates its tables. The 
executive must set up the exchange package area. When CPUMTR 
picks up the request it exchanges in the subcontrol point and 
sets the flag in the control point area to indicate that there is 
a subcontrol point at the control point. 

Transaction Subcontrol Points 

Transaction subcontrol points are all (0,0) absolute overlays. 
These programs are loaded by the executive using a CIO function. 
The executive also sets up an exchange package for each 
subcontrol point so that each subcontrol point can use only 
memory within its own RA through RA+FL-1 . 

The transaction executive has set up one subcontrol point (IT ASK) 
which decides which other program needs to be brought in to 
handle a transaction. ITASK can look at the transaction code from 
the user and find the name of the program to do the task. Since 
ITASK is a subcontrol point itself and cannot go outside its own 
field length, ITASK must ask the executive to activate the 
appropriate transaction program at a subcontrol point. 

When a subcontrol point needs assistance from the executive, it 
puts a request in its own RA+1 ; this causes an exchange back to 
the executive. The executive looks at the request and can: 

1 . Ignore the request 

2. Process the request itself 

3. Pass the request on to CPUMTR 

After the request has been handled, the executive can give 
control back to the subcontrol point if its is appropriate. 
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An example of a request would be a subcontrol point requiring the 
loading of another subcontrol point to complete a task. When the 
first subcontrol point puts the request in its RA+1, the 
executive is exchanged in; the executive brings in a copy of the 
program if necessary and copies the communications block from the 
calling program to the called program. The RA+1 of the subcontrol 
point is within the FL of the executive who can read the request. 
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PERIPHERAL PROCESSOR RES I DENT (PPR ) 



PPR/.SYSTEM INTERACTION 

Each PP functions i ndependent ly of the CPU and other PPs. To 
enable the PP to communicate with and work for the system, PPR 
provides the necessary Links between the PPs and the CPs. PPR 
serves as a PP idle program, the Loader of PP programs, and a 
source of commonly used subroutines for other programs and 
routines. PPR is loaded into pool PPs at deadstart time by STL 
and is never changed. A dedicated PP program such as 1TD (the 
multiplexer driver) overlays PPR and restores it via 1RP prior to 
dropping back to pool PP status. MTR (PP monitor) and DSD 
(display driver) are two other dedicated PP programs which do 
not contain a copy of PPR. 



Initially, PPs can be loaded only at deadstart time by 
transferring data across their respective channels (refer to 
section 26). This method of loading PP routines during normal 
system operation is unacceptable because other peripheral 
equipment may be on the channels. The alternative is to have 
each PP execute an idle loop which checks the status of a word 
in CM. This is accomplished through the PP communication area 
in CMR. There is one entry for each available PP, and each 
entry is 10B words in length (refer to section 2). 



The first word of each entry is the input register (IR), the 

second word is the output register (OR), and the remaining six 

words are used as a message buffer. A sample entry is as 
f o I lows . 



IR 
OR 

MB+O 

• 

MB + 5 



input 


register 


output register 


six- 


- word v 



message 
buffer 



The CM addresses for each PP input register, output register, and 
message buffer are stored in direct cells named IA, OA, and MA 
in each PP. These are 12-bit absolute CM addresses and, 
therefore, the PP communication area must reside below address 
10000B. 
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PP Resident 



PP 
C ornmun ica t i on 
Area 




XXX 



me s sa ge 
buffer 







PLL 



load peripheral^ 

library routine/ 

XXX 



load and 
execute 

requested 
program 



inform 
monitor of 
end of 
operation 




IR 


XXX 


OR 


DPPM 


> 










IR 





OR 


















CP Monitor 




assign PP 

to this 

control 

point 



monitor 
checks PP 

output 
register 



JL 



clear IR 

and OR 

and indicate 

PP is free 



Figure 4-1 ■ - System Interaction - PPR 



60454300 A 



4-3 



Table 4-1 represents a pool PP memory map. The address to the 
Left is the first word address of the functional area. Direct 
cells are memory locations through 77B. The mass storage 
buffer is normally located at address BFMS for those routines 
requiring mass storage I/O. The first executable instruction 
begins at PPFW (1100B) with a one CM-word library table entry 
preceding it at 1073B. Mass storage drivers are loaded at MSFW 



TABLE 4-1 . POOL PP MEMORY MAP 



FWA (Octal) 



Rout i ne/ Fun ct ion 



Name 



0000 
0100 



0077 
1100 



Direct cells 

PP resident routines and mass 
storage driver area 

Idle loop 

Peripheral library loader 

Load MS error processor 

Process monitor function 

Pause for relocation 

Reserve channel 

Release channel 

Send dayfile message 

Execute routine 

Set mass storage 

Mass storage driver designator 



PPR 
PLL 
LEP 
FTN 
PRL 
RCH 
DCH 
DFM 
EXR 
SMS 
MSD 



60454300 A 



4-4 



TABLE 4-1. POOL PP MEMORY MAP (CONTINUED) 



Rout i ne/ Funct ion 



FWAof mass storage drivers 

Read sector 

Write sector 

End mass storage 
ope rat ion 

Library entry of current PP 
rout i ne 

First word of PP routine 

Mass storage buffer (502B 

words) 
MS e rror processor 

Last word of PP 



N am e 



MSFW 
RAS 
WDS 
EMS 



PPFW 
BFMS 
EPFW 
7777 
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PPR SUBROUTINE DESCRIPTIONS 

Whenever a pool PP is waiting to be assigned, it executes the 
idle Loop, PPR. This routine reads the input register in CM 
every 128 microseconds (for both 1X and 2X modes). That is, if 
byte of IR is zero, the PP delays 128 microseconds before 
reading IR again. If IR is nonzero, then the name of the 
requested PP program is in IR, and that routine is loaded and 
executed . 



In order to load a PP program or overlay, subroutine PLL is used. 
This routine requests monitor to search the PLD for the requested 
routine (monitor function SPLM) . If the overlay is found, it is 
loaded; if it is not found, overlay SFP is loaded. If SFP does 
not recognize the PP overlay named in IR, the error message xxx 
NOT IN PP LIBRARY is issued and the control point is aborted. 
The PP then reenters the idle loop. 



Subroutine LEP is used to load the mass storage error processing 
overlays from CM. 



Subroutine FTN is called to issue monitor requests. The 
function is stored in the output register. If this is a CPUMTR 
request, FTN executes a monitor exchange instruction (MXN). If 
not a CPUMTR function, FTN waits for the completion of the 
function. Completion is indicated by byte of OR being set to 
zero by monitor. FTN then returns control to -the calling 
rout i ne . 



If a PP is assigned and executing at a control point, that 
control point cannot be moved by monitor. To enable a storage 
move, the PP must pause by using subroutine PRL. If a move 
takes place, CM addresses being used by the PP routine will have 
to be adjusted because RA has changed. Do not use PRL with 
nondedicated channels reserved. 



Subrout ines 
reserve and 



RCH and DCH issue monitor functions 
release a channel or pseudochanne I . 



RCHM and DCHM to 



When a PP issues a dayfile message, subroutine DFM is used. The 
appropriate dayfile is selected and the message is passed in 40- 
character blocks through the PP message buffers. Again, do not 
use DFM with nondedicated channels reserved. 



For a PP program to load an overlay, subroutine EXR 
not use EXR with nondedicated channels reserved. 



is used 



Do 



Subroutine SMS is called to load the proper mass storage 
driver into PPR. SMS must be called prior to a request for 
positioning or I/O (POS, RDS, and WDS). 
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NOS PP NAMING CONVENTIONS 

The following PP naming convention is used by NOS. 

xxx Three alphabetical characters, used for RA+1 
callable overlays (for example, CIO). 

Oxx Zero level overlay, also known as location-free 
routine (for example, OAV) . 

1xx Reserved for system programs. 

2 xx Reserved for system programs. 

3xx Reserved for system programs. 

4xx Reserved for system programs. 

5xx Reserved for diagnostic programs. 

6yy Mass storage driver (for example, 6DI); callable by 
SMS in PPR. 

7yy MS error processor (for example, 7DI); called by LEP 

in PPR. 

8xx Unused 

9xx Syntax and display type overlays used by DSD, DIS, 

1 TD, and 1LS. . 

In the preceding list, x refers to any alphabetic character and 
yy is a mass storage driver mnemonic (DE, DI, or DP). 



NOTE 

User programs can call a PP routine only if its name 
begins with an alphabetic character. Routine names 
beginning with a numeral character are callable by the 
system, other PP routines, subsystems, or special system 
jobs. 
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ERROR MESSAGES 

ALL error messages from PPR are issued by the routine SFP. The 
dayfile messages are as follows. 



Message 
xxx NOT IN PP LIB. 



xxx NOT IN PP LIB. - 
CALLED BY yyy. 



Desc ri pt ion 

PP package xxx was not found in 
the PP Library directory. 

PP ove r Lay /program xxx was not 
found in the PP Library directory 
and was called by package yyy. 



SFP/xxx PARAMETER ERROR. Parameter address outside FL. 

SFP/xxx ILLEGAL ORIGIN Function illegal for user's job 
CODE. ori gin. 



SFP CALL ERROR 



SFP not loaded by default. 



DIRECT CELLS 

Table 4-2 shows the direct Location assignments available for PP 
routines. Cells ON, HN, TH, TR, IA, OA, and MA must not be 
changed by the PP routine. All others may be used. However, 
remember that TO i s used to hold the P register for the CRM, CWM, 
IAM, and 0AM instructions and, therefore, is subject to change. 



ROUTINE RESIDENCE 

All PP routines reside in either the resident peripheral Library 
(RPL) in central memory or on mass storage, and are pointed to 
by the peripheral library directory (PLD). System performance 
can be affected by the residence of frequently used routines. 
Further, the following routines must reside in CM in the RPL: 
1MB, 1MC, 1DD, SFP, ODF, 7SE, 7EP, and all the mass storage 
drivers and error processors. Other routines recommended to be 
in the RPL are contained in the default LIBDECK re Leased with 
NOS. 



1 DD AND 1RP 

Two routines associated with PPR are 1DD and 1RP. Routine 1DD 
is called by DFM when a dayfile buffer is full and requires 
flushing to the disk. Routine 1RP is called by a PP routine to 
restore that PP's copy of PPR. For instance, 1TD (the 
multiplexer driver) calls 1RP to restore PPR when TELEX is 
dropped. This is done by passing a copy of PPR from another PP 
through the message buffer. 
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TABLE 4-2. DIRECT LOCATION ASSIGNMENTS 



Symbol Name 



Location (Oct al) 



Desc ri pt i on 



TO 

T1 

T2 

T3 

T4 

T5 

T6 

T7 

CM 

LA 

IR 
RA 
FL 

ON 

HN 

TH 

JR 

CP 

IA 
OA 
MA 




1 
2 
3 
4 
5 
6 
7 
10 
15 



Temporary storage 



CM word buffer (five 

Locat i ons) 
Package load address 



Set by PP resident before entry to program 



50 
55 
56 



Input register (five 

locat i ons) 
Reference address/100 

Field length/100 



Read-only constants 

70 | Constant 1 
I 

71 | Constant 100B 
I 

72 | Constant 1000B 
I 

73 I Constant 3 



Set by PP resident before entry to program 
74 | Control point address 



Read-only constants 

75 I Input register address 

I 

76 I Output register address 

I 

77 | Message buffer address 
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In figure 4 - 2 , 1TD is running in PP2 and needs to restore PPR 
prior to dropping. Routine 1TD requests 1RP via RPPM. CPUMTR 
assigns an available pool PP (say PP4) to execute 1RP. Next 
CPUMTR informs PP2 which PP was assigned. Now that both PPs 
acknowledge each other, PP4 can pass its copy of PPR to PP2. 
This is done in six-word blocks using PP2*s message buffer. 
Completion is marked by a short (less than six words) transfer. 

7SE 

Routine 7SE is called by routine PLL in PPR when an error occurs 
loading a routine from mass storage. If the routine was on an 
alternate system device, the library entry is changed to point 
to the routine on the system device. Routine 7SE then returns 
to PLL to retry the load from a system device. 

7EP 

Routine 7EP is called after a DEPM monitor function to further 
process the disk error. Routine 7EP issues the dayf i le messages, 
processes unrecovered errors and return and retry operations. 
Routine 7EP is also called after recovered disk errors to issue 
a message to the error log indicating the recovery status. 



IR 


1TD 




OR 




IA 






FE 


MB 


six words 

of 

PPR 





1RP 



RB 



id 



PP2 



PP4 



IA Input register address for 1RP (byte 1). 

ia Input register address for 1TD (byte 4). 

FE Full/empty flag (1TD sets FE=0 to indicate empty 

buffer and 1RP sets FE=1 to indicate full buffer). 

RB Ready byte (byte 2). When 1RP is ready to transmit, 
byte 2 of 1RP's IR is set to 7777B. 1RP then waits 
for RB=0 before the next transmit. If this does not 
take place within 1 second, -1 RP exits, thus aborting 
the load . 

Figure 4-2. 1RP - Restore PPR 
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PP RESIDENT FLOWCHARTS 

Figures 4-3 through 4-9 illustrate the PP resident routines 



Entry 59 
IR 



program name 



40 



I — control point 
35 



arguments 



( pprJ 



read IR 
address 
and IR 



set control 

point 

address 

in CP 



load 
program 
name 




delay 

128 

micro seconds 



yes 




no 



PPL 



load 
program 



enter 
program 



*1 



*1 LJM 5, LA 

LA contains the program load address. The first 5 
words of the program are loader information. 



Figure 4-3. PP Resident (PPR) 
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Entry (A) = program name 

(LA) = Load address for zero Level overlay 



© 



store 
program 
name 




reset input 
register 



set load 
address 




load from 

RPL into 

PP memory 

(CRM) 



set equipment 
track and sector 
from output 
register 



Jl 



pause 



perform 

SETMS with 

READSYS 

option 




( return J 



Figure 4-4. Peripheral Library Loader CPU) 
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no 



t 



IT 




RDS 



next 
read sector, 




yes 



process 

error on> 

system \ call 7SE 

device 




set up 

for next 

sector 



pause 



return 




no 




Figure 4-4. Peripheral Library Loader CPU) (Continued) 
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Entry (A) = MTR function 

(CM + 1 through CM+4) = parameters 
(CP)= Control point number 

Exit (CM through CM+4) = OR 
(A) = 



O 







store 

function 

in CM 



read CMCL 
from CMR 



set PRLM 
in A 









write CM 
through CM+4 
in OR 




Figure 4-5. Process Monitor Function (FTN) 
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store P, AO, 
BO in PP 
exchange 
package 




have CPUMTR 

note exchange 

request 



set 
timer 




Note: (P), (AO) and (BO) are from PXPP+1 in CPUMTR 
Figure 4-5. Process Monitor Function (FTN) (Continued) 
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no 



delay 128 
seconds 



read OR 



read control 
point RA+FL, 
set IN direct 
cells RA+FL 



yes 



N. rejected yr 





delay 1 
millisecond 



reset function 
in CM 
for retry 




Figure 4-5- Process Monitor Function (FTN) (Continued) 
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Entry (A) = 1 or 2 channel numbers *2 

(CM+2) = additional channel numbers 
(if more than 2 needed) 



Exit 



(CM+1) = assigned channel 
(bot) * 2 



store 
channel 
numbers 
in CM+1 



FTN 



RCHM 



return 



Reserve channel function 



Entry 



NOTE 
Storage move 
may occur wh i le 
this f unct ion 
i s pendi ng. 



(A) = channel number 




store 
channel 
number 
(CM+1) 



FTN 



DCHM 



Release channel 
function 



return 



*1 RCHM will assign one of the channels requested if it can. (A) 
and (CM+2) are used for optional channels. 

*2 This entry point will not be supported in future versions of 
NOS. 

Figure 4-6. Reserve Channel (RCH) 
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Entry (A) = FWA of message (0-11) 

message code (12-17) 




(dfm J 



store message 
address/code 



place message 

in message 
buffer (up to 
40 characters) 




store 

message code, 

in CM+1 




( DFM7) 

_L 



save cells 2-110B, 
MS driver, MS 
error processor, 
& program 



call 1DD 
to dump 
dayf ile 



*1 OayfiLe message function 



Figure 4-7. Send Dayfile Message (DFM) 
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PAUSE 



pause for 
relocation, 




Figure 4-7. Send Dayfite Message (DFM) (Continued) 
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Entry (A) = Routine name 

(LA) = Load address for location- 
free routines 



Exit 



Exit to called routine via simulated 
return jump from caller 

Example: Call overlay 2XY 

(A) = 2XY 

(LA) = load address 

RJM EXR 




set return 
address 
from caller 
-*(LA) + 6 




then core from (LA) to (LA) + 7 is 

(LA) +0 2X 

1 Y- 

2 load address 

3 

4 length 

5 0100 LJM 

6 return address from 
caller of EXR 

7 1st executable state- 
ment address 

proprara 2XY at completion does a 
RETURN, which is a LJM (LA) + 5, 
which will LJM (return address 
from caller) . 



Figure 4-8. Execute Routine (EXR) 
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Entry (T5) = Est ordinal (refer to section 2 for description 

of EST entry) 

The address of the i ni t i al i ze routines for all 
drivers begins at MSFW. These routines set the 
appropriate preset information for that 
equipment. 



Exit 



(CM+1) through CCM+4) = EST entry bytes 1 to 4 
Driver loaded if necessary 
Driver initialized 




read EST, 

MST word 

MDGL 



jump to 
driver 
preset 




load 
proper 
driver 



FTN 



SPLM 



I 



set device 

type in 

MSD 



*1 ESTS = FWA of EST 
*2 SMS has stored the 
loaded/ so that it 
the loaded driver. 



driver name 
can compare 



in MSD when that driver was 
new dr i ver requirement against 



Figure 4-9. Set Mass Storage (SMS) 
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DAYFILE MESSAGE OPTIONS 

A normal dayfile message is sent to the master dayfile, control 
point dayfile, and control point message area. The job name is 
defined in the control point area. Following are the dayfile 
message options. 



Opt ion 

(00000) 
NMSN (10000) 

JNMN (20000) 

CPON (30000) 

ACFN (40000) 

AJNN (50000) 

ERLN (60000) 

EJNN (70000) 

FLIN (400000) 



Desc ri pt ion 

Normal message 

Normal message with no message at control 
poi nt 

Message to master dayfile only, with job 
name 

Message to control point dayfile only 

Message to account dayfile only 

Message to account dayfi le with job name 

Message to error log only 

Message to error log only with job name 

Flush and interlock dayfile 



The FLIN option flushes the dayfile buffer and leaves the 
dayfile pointers interlocked. It is used in conjunction with 
any of the preceding dayfile options. If the message is issued 
to more than one dayfile, each is flushed and left interlocked. 
FLIN is used by SFM to terminate an active account, error log, 
or system dayfile. 



MASS STORAGE DRIVER RESIDENT AREA 

Mass storage drivers are overlays loaded by PP resident in an 
area between PP resident and the first word address of PP 
programs. Mass storage drivers are coded such that the entry 
points remain constant between all drivers. 

Parameters passed to the driver are: 

(T4) = channel 

(T5) = equipment number 

(T6) = track 

(T7) = sector 



60454300 A 



4-22 



The rules are: 

• Name is the character 6 followed by the equipment 
mnemonic, 

• Origin is MSFW. 

First word is the address of the driver initialization 
routine. This entry is used by SMS to cause 
initialization.. of the driver. Exit from initialization 
is to SMSX. SMS enters the initialization routine with 
CM to CM + 4 = EST pa r amet er s , SLM-4 to SLM = MDGL word 
of MST. 

• The entries for read, write, and position originated 
at the appropriate symbolic names (RDS, W D S , EMS). 
These entries are entered via return jump. 

• The driver must not use any direct locations except 
T1, T2, CM to CM+4. 

• The driver and its associated error processor must 
res ide i n RPL . 

All drivers use the following three entry points. 

RDS Read sector 

Entry driver initialized CSMS called) 

(TA) = channel (if driver previously 

ca I led) 
(T5) = equipment 
(T6) s track 
(T7) * sector 
(A) = FWA of data buffer (502 word buffer 

needed) 

Exit (A) = -0, if unrecoverable error 
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WDS Wri te sect or 

Entry driver initialized (SMS called) 

(T4) = channel (if driver previously 

ca I led) 
(T5) = equipment 
(T6) = track 
(T7) = sector 
(A) = FWA of data buffer (502 word 

buffer needed) + WCSF for WLSF 
(WOSE) = Write error processing buffer 

address (502 word buffer) 

Exit (A) = -0, if unrecoverable error 

(A) = -1 , if recovered error on previous sector; 
current sector data and linkage bytes 
must be regenerated and reissued 

EMS End mass storage operation 

Entry (T4) = channel, if RDS/WOS previously 

ca I led 
(T5) = equi pment 

All drivers begin at location MS FW. 



Use of mass storage drivers is described in detail in section 7. 
Refer to table 4-3 for a list of symbols used with mass storage 
dri vers . 
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TABLE 4-3. SYMBOLS USED WITH MASS STORAGE DRIVERS 



Symbo I 



Va lue 



Descri pt i on 



MSD 

MSFW 
RDS 
WDS 
EMS 



BFMS 
FSMS 



FNSS 
EQSS 
FTSS 
FASS 
DTSS 



MSFW+1 
MSFW+4 
MSFW+7 



Mass storage driver • 
identification 

FWA of mass storage drivers 

Read sector 

Wri te sector 

End mass storage 



Other mass storage processing constants 

I Sector buffer address 

| I 

I First data sector of file 



System sector addresses 



BFMS+2 
BFMS+2+5 
BFMS+2+6 
BFMS+2+1 1 
BFMS+2+1 2 



FNT entry (five bytes) 
Equipment number 
First track 
Address of FST entry 
Packed time/date 



Whenever a PP program desires to read or write mass storage, 

the program always executes a SETMS macro with the appropriate 

option selected. A flowchart of SMS is illustrated in figure 
4-9. 
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JOB PROCESSING 



ALL jobs which fLow through the system are processed from start 
to finish by PP routines 1SJ, 1AJ, 1CJ, 1R0, 1RI, and (in the 
case of time-sharing origin jobs) 1TA. FLow is controLLed by 
the queue priorities and CPU priorities, in association with 
time and equipment Limits. Depending on the resources needed 
the job, aLL action is initiated, controLLed, and eventually 
error- or end-processed by these routines. 



ALL jobs are one of the foLLowing origin types. 



by 



Origin 
Type 

SYOT 



Va Lue 



Description 

System origin incLudes aLL jobs 

entered by the operator at the system 

console, such as DIS, FST, MY1, and 
so on . 



BCOT 



Local batch origin jobs are entered 
from aLL Local batch devices. 



EIOT 



Remote batch origin jobs are entered 
from the remote Low speed batch 
t ermi na Is . 



TXOT 



AIL jobs entered via the IAF 
executive (IAFEX) or time-sharing 
executive (TELEX) are TXOT origin 
types . 



MTOT 4 Multi-terminal origin includes jobs 

which do one specific task for many 
terminals while only being scheduled 
into the system once. 

Figure 5-1 illustrates the general system flow for jobs. 



GENERAL JOB PROCESSING 



The 

cons 

i n C 

syst 

PROF 

less 

pr i o 

memo 

mass 

stor 

dr i v 

acco 



pno 
o le 
MR c 
em. 
ILa 

res 
ri t i 
ry t 

sto 
age 
ers 
unt i 



ri t i 
and 
onta 
Eac 
f i le 
trie 
es i 
ime 
rage 
devi 
that 
ng a 



es a 
upda 
i ns 
h jo 
, or 
ted 
n th 
s Li c 

dev 
ces 

are 
ccum 



re c 
ted 
the 
b ca 

job 
than 
e in 
es, 
1 ces 
onl i 

una 
ulat 



ont r 
by r 
cur r 
n be 
s ta 
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or. 



oiled dynamically at the operators 
outine ISP. The job control (JCB) area 
ent values of these priorities for the 

further restricted by the VALIDUs file, 
tement parameters, but no job can be 

JCB. Routine 1SP also updates queue 
and rollout queues, checks central 
odically calls 1CK to checkpoint all 

CMS to initialize or recover mass 
issues dayfile messages for mass storage 
to do so, and calls OAU to process the 
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OUTPUT QUEUE 
list of jobs to be disposed 



Figure 5-1. General System Flow 
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Jobs enter the system at the initial ' (origi nal) queue priority 
for their origin type (figure 5-2'). As they wait in the input 
queue, they are aged. The queue priority is increased until it 
reaches the upper bound priority, at which point the priority 
cannot be raised,. At any time, the scheduler, 1SJ, may determine 
that this job is the best candidate (best job) for a control 
point by an algorithm that takes into account queue priority and 
resources desired (Ft, etc.). It then attempts to schedule or 
assign it to a control point. 





J08NAME 



ift|o 



INFT 



Input queue entry 



*1 



TXOT/MTOT 
by DSD. 



are started by IAFEX or TELEX and SYOT is initiated 



Figure 5-2. Read Card Reader 



The job selection proceeds in the following order. 

1. The highest priority job that will fit in unassigned or 
rolling memory with the service constraints FL/FIE 
(individual job fieLd length) and AM (maximum amount of 
memory available) for the candidate's origin type. 

2. If candidates of equal priority are found, the job 
selected is the one residing on the mass storage device 
with the least amount of activity. The amount of disk 
activity includes no free channel, channel being 
requested, and first unit reserved. 
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3. If the mass storage activity is also equal, the job with 
the largest field length is selected. 

4. If no job is selected, but one was rejected due to 
service constraints, it may be scheduled if no jobs have 
to be rolled out. If this is done, its priority is set 
to the lower bound priority (LP). This prevents 
resources from being idle during periods of low 
activity. 

When 1SJ assigns the best job to a control point, it gets the 
required FL, rolling out other jobs if necessary. It selects a 
control point according to the following criteria. 

1 . Exact fit 

2. Smallest hole that is larger than needed 

3. Largest hole if none is big enough 

If no control points are available or are not in the process of 
rolling out, the first control point encountered with a lower 
priority than the candidate is selected to be rolled out. If 
all control points have higher priority than the candidate or 
control points are not available or are rolling out, no control 
point is se lected . 

Once a control point has been identified, its queue priority is 
set to the upper bound priority (UP) of the job's origin type 
and its CPU and CM time slices are initialized. 

If the job is being scheduled from the input queue, 1AJ is 
called to begin the job; if the job is being scheduled from the 
rollout queue, 1RI is called to roll in the job (figure 5-3). 
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Input queue 



JOBNAME 



INFT 




JOBNAME 



JNMW 



INPUT 



INFT|<ft 



FL area 
of CM 



Figure 5-3. 1SJ Prepares a CP for the Job 

The job advancement routine, 1AJ, knows it has been called by 
the scheduler and will call overlay 3AA (figure 5-4) to start 
this job up. The job can at any time create local files, and 
if the name is OUTPUT, PUNCH, PUNCHB, or P8 it is treated 
special at job completion time (figure 5-5). 
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CPA 




INPUT 



INFT 



cp 
no. 



Reads first control 
statement, loads 
first routine, 
starts job 



Figure 5-4. 1AJ Starts the Job 



OPTIONAL 



CPA 




INPUT 



INFT 



cp 
no. 



OUTPUT 



PRFT or 
PHFT 



cp 
no. 



Figure 5-5. Job Creates Local File 



As the job progresses, CPUMTR and MTR periodically check all the 
jobs running at control points and call 1AJ if no activity is 
detected (W, X, and I status zero). If the error flag is set, 
1AJ processes the error. If the error is nonfatal, 1AJ advances 
to the next control statement. If the error is fatal but an EXIT 
statement exists, 1AJ advances to the statement following EXIT, 
CPUMTR and MTR also monitor the CPU time slice, and if the job 
exceeds its time slice, its queue priority is dropped to the 
lowest queue priority (Ip) of that origin type. This does not 
mean that the job loses its control point. If 1SJ finds a best 
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job in the input or rollout queues, then low priority jobs are 
candidates for rollout. Also, 1SP monitors all the contol 
points, and if it detects that the CPU time slice is exceeded 
before either monitor does, it lowers the queue priority to LP. 
An interlock is provided in bit 35 (CPU time slice active bit) 
of TSCW in the control point area so its queue priority is only 
dropped once. 

Routine 1R0 may be called by 1AJ, 1SJ, DIS, and other routines 
(figure 5-6). It dumps the job according to the rollout file 
format, sets W, X, and I status to zero, requests the control 
point be made available, and releases all FL, nona I locatab le 
equipment (tapes are not released, but the control point number 
in the EST is set to 37B), and all files assigned to this 
control point. The job is then placed into the rollout queue 
with whatever queue priority the job had when rollout was 
initiated. If 1R0 is called as part of special entry point 
processing by 1AJ, the rollout file is called DM* and left as- 
signed to this control point. Then 1R0 releases everything else 
except the input and control statement file, and calls 1AJ to 
advance the job. In this way FNT space is not wasted while a 
job is rol led out . 



Routine 1 R I reads 
f i les, equi pment , 
(figure 5-7) . It 
The cont ro I poi nt 
gets a fresh t i me 



the rollout file and reestablishes all the 
and so on, to allow the job to continue 
sets W, X, and I status to its former values. 
is now a candidate for the CPU. A job always 
slice when it is rolled in. 



When 1AJ detects an end-of-job card stream, a fatal error with 
no recovery, an illegal control statement, or some other fatal 
condition, it calls 1CJ to complete the job. If any of the job 
flow routines ever detect an origin type which is not defined 
(type not SYOT, BCOT, EIOT, TXOT, or MTOT), it calls 1CJ 
immediately to end the job. This is protective coding. 

Routine 1CJ locates the local file OUTPUT assigned to this job, 
if it exists (figure 5-8). It then appends the job dayfile to 
the end, writes an EOI, and moves the f i le to the output queue 
by setting the control point field to zero and setting the queue 
priority to the output queue entry priority (OP) for the origin 
type. 
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*1 And any other LocaL files 
*2 This is the same FNT entry 



Figure 5-6. Job Is Rolled Out 
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JOBNAME 



ROFT 







INPUT 


INFT 


cp 
no. 








OUTPUT 


LOFT 


cp 
no. 





*3 



*1 And any other Local files 

*2 Not necessari ly same control point area and field length as 

figure 5-6 
*3 This is the same FNT/FST entry 



Figure 5-7. Job Is Rolled In (From Rollout) 
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CPA 




FL 












( 




X 


i 


t 







JACM 



Release 
CPA and FL 




•1 Same FNT/FST entry as Local OUTPUT file. 

Change OUTPUT file name to JOBNAME and file type from LOFT to 
PRFT. Append dayfile onto end of OUTPUT file. 

1CJ also returns alt files associated with this job except 
OUTPUT type files. 

Figure 5-8. Job Completes 
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JOB FLOW 

This section provides an overview of priority aging, rollout, 
scheduling, queues, and control statements . The details for the 
routines that do the actual processing (1AJ, 1RI, 1R0, 1SJ, 1SP, 
1CJ) are presented in another section. 



PRIORITY AGING 

A job of a particular job origin type waiting in the input, 
rollout, or output queue is aged if its current priority falls 
between the lower priority and the upper priority limits. 

A job is aged by the scheduler in conjunction with the job 
control area parameters in CMR. The job control area word 
is illustrated in section 2. 



es 
i nc rement 



For each cycle of the priority increment routine (1SP), the 
counter (byte 4 of JCB) is incremented by one. This continu 
until the counter is greater than or equal to the age increm... 
(byte 3 of JCB). At that time, the job queue priority is aged 
the FST entry by one. Refer to the NOS Installation Handbook 
for the IPRDECK entries used to establish the JCB values for 
each job origin type, and the NOS Operator's Guide for the DSD 
commands to dynami ca I ly a 1 1 er them. 



i n 



QUEUES 

The queues (input, output, rollout, for example) are FNT/FST 
entries in the FNT/FST table area of CMR. When a routine checks 
a queue, it searches the FNTs for entries with the appropriate 
file type which are not assigned to a control point. 

When a job is moved from the input or rollout queues to a 
control point, the file name field of the FNT word contains 
INPUT instead of JOBNAME. The control point assignment field is 
set to the control point number and the queue priority is set 
accordingly (input or rollout UP). 

When a job is sent to the rollout queue, the FNT name contains 
JOBNAME instead of INPUT. The file type is set to rollout 
(ROFT), the control point assignment field is set to zero, and 
the queue priority is set to whatever the control point area held 
at ro I lout t ime . 

When a job completes, the special FNT name OUTPUT, if one exists, 
is changed to JOBNAME. The file type is changed from local 
(LOFT) to output (PRFT), the control point assignment field is 
set to zero, and the queue priority is set accordingly (output 
OP). This is also done for special files named PUNCH, PUNCHB, 
or P8 with the exception that their file type is changed to 
punch (PHFT). 
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ROLLOUT SCHEDULING 

When a job is scheduled for rollout, the rollout-request flag, 
bit 24 in word JCIW of the control point area, is set and 1R0 
may or may not be called. When 1R0 is called (by ROCM) it sets 
the rol lout-in-progress flag, bit 27 in JCIW. When 1R0 has 
rolled the job out, it resets these bits to zero. Also, if 1R0 
was called by a special entry point routine, 1R0 sets these 
flags to zero. A special entry point job can also be scheduled 
to be rolled out. In this case, when 1R0 is called it is a 
regular rollout, not a response to a special entry point job. 
Many copies of 1R0 and 1RI can be run simultaneously. 



SCHEDULER 

Only one copy of 1 S J may run at any one time, and it can only be 
called by the monitor function RSJM. RSJM checks the scheduler 
active flag in JSCL+1 (bit 59) and if the bit is set, the 
scheduler is already active. If the bit is not set, monitor 
places a call to 1SJ in the next available PPU. 

Any time the status of the system changes, 1SJ should assess the 
status and modify system flow as needed. The scheduler selects 
candidates as described earlier. It continues to select 
candidates until mass storage activity reaches a given limit or 
until no more candidates are found. In a normal job mixture, 
all jobs are eventually scheduled and any minor delay in the 
scheduling of one particular job is inconsequential to the total 
throughput of the system. 

Figure 5-9 illustrates a typical queue priority scheme. 
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If the entry point name is not found, the peripheral library 

directory (PLD) is scanned. If found, the routine is loaded into 

a PP (set IR equal to the routine name and argument) and TCS 
termi nates . 



If no match is found, an appropriate error message is issued to 
the dayfile and error procedures are initiated by setting the 
error flags and returning to 1AJ. 

Before a CPU program is given control, TCS places the control 
statement image which called this overlay into central memory 
locations RA+70 through RA+77. Also, the control statement 
which was cracked by TCS and parameters are placed in locations 
RA+2 through RA+62 terminated by a zero word. If the control 
statement is preceded by a slash, the parameters are cracked in 
operating system format; otherwise they are cracked in product 
set format. All compiler (FTN and COBOL, for example) binaries 
expect control statements to be cracked in product set format. 

• Operating system format (6-bit ID code): 

59 17 5 



parameter (7 characters) 





id 



id 



for all separators except = and /, and 
in those cases the character is placed in 

the 6 bits. 



• Product set format (4-bit ID code): 

59 17 



pa rame te r 



String of characters 
separator 



3 



parameter (7 characters) 





id 



up to the 
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id 



RA + 2 
3 
4 
5 
6 
7 
8 
9 
10 
11 



11 


1 
2 
3 
4 
5 
6 
7 
10 
17 



Separator equivalence: 
Separator 
Continuation (for Literals) 



Space 

Termination) or . 
For example, the control statement 

MODIFY (I,P=0,N=F I LE , A, NR , X, CL ) 
would be passed as follows: PGNR = RA + 64B = MODIFY 11B 



Operat i ng System 

42 12 6 



|i loll 


| P I I * I 


I o loll 


In I Q I - I 


I FILE I I I 


I A I0II 


I NR I | I 


| X |0|| 


| CL t I I 


| Binary Zeros I 



6-bit code is display 
character when used 
and binary zeros when 
b lank. 



Full word of ze ros 
terminates control 
statement . 



Product Set 



42 14 4 


I I | I 1 I 


I P | | 2 I 


I | Oil - 1 


In 1 o 1 2 1 


I FILE | | 1 I 


I A | | 1 I 


| NR | | 1 I 


| X | | 1 I 


| CL I |17 | 


| Binary Zeros I 



4-bit code is binary 
numbe r . 

One word of zeros preceded 
by other than a code 17 
implies another control 
statement . 
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The flow chart in figure 5-10 shows the flow of control statement 
processing. Routine 1AJ processes CTIME, RTIME, and STIME 
directly. 

Local absolute files with multiple entry points cannot be loaded. 
However, local relocatable files with multiple entry points can 
be loaded. 

The type of automatic parameter cracking depends upon whether 
the load is from a system or local file. If a system load, the 
default is operating system format unless *SC is specified in 
LIBDECK. If a local load, default is product set format unless 
a slash (/) precedes the control statement. 
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Figure 5-10. Control Statement Processing 
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Figure 5-10. Control Statement Processing (Continued) 
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SPECIAL FILE INPUT* 

When the user returns the file INPUT, file INPUT* is set up to 
point to the input file, but the user cannot access it. 

When a procedure file call is encountered, the procedure file is 
expanded on file INPUT*. 

When a procedure file from the system is encountered, a dummy 
call is generated to the CPU routine CONTROL or BEGIN (if a CCL 
procedure) and the expanded file is pointed to by INPUT*. 

When any combination of the preceding occurs, INPUT* is used to 
link up the several files. 

NOTE 

The file INPUT* may not explicitly exist for 
precedure file calls. Thus there is no FNT/FST 
entry, but INPUT* is pointed to by CSPW in the 
control point area (bit 59 in word CSSW) . 



TIMED/EVENT ROLLOUT PROCESSING 

When a CPU program goes into timed/event rollout, it uses the 
ROLLOUT macro and specifies an event and/or a time. Routine 1R0 
is called to roll the job out and create an FNT/FST with file 
type TEFT (refer to section 2). 

When 1SP is called by 1SJ it checks each entry in the TEFT queue 
and if the rollout time period has expired it changes the entry 
to a regular ROFT entry. If the time period has not expired, 
1SP uses the EATM monitor function to read the event table from 
MTR's field length. It compares the events with this 18-bit 
event descriptor and if there is a match 1SP changes the entry 
to a regular ROFT entry (refer to section 2). 



60454300 A 



5-19 



EESET Macro 

Only P'P programs may access the event table via the EATM MTR 
request. Therefore, the macro EESET allows a previously set 
event to be matched by an event set by a CPU program- The 
format of the EESET macro is as follows. 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




EESET 


event 



event 



18-bit event descriptor 



The event is an 18-bit value that has the following format. 
17 11 



eq 


condition 



eq 



condi t ion 



EST- ordinal of equipment on which the 
system is waiting for condition to occur 

Variable event condition. 



EESET calls CPM to enter an event descriptor into the event 
table. A job must have SYOT origin to use the EESET macro. 



The only PP routines currently using the EATM function are the 
f o I lowi ng . 

• CPM for EESET enter event. 

• IMS and MSM to specify when a removable pack has been 
initialized or recovered (for missing pack name event). 

• ORP to specify when a write mode permanent file is no 
longer busy and to specify when a removable pack has been 
returned and has no more users (for overcommitment event) 

• OFA to specify when a write mode fast attach file is not 
busy. 

• 1DS to specify when the operator has supplied a VSN. 

• 1MT to specify when a VSN has been mounted (for missing 
VSN event) or when a tape unit has been returned (for 
overcommitment event). 
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DSD and PIS Commands 

In all DSD file displays the timed/event rollout files are 
displayed as TEFT file types. In addition, the Q display has 
all TEFT rollout files flagged by **. 

The DSD command, R0LLIN,xx. may be used to roll in a TEFT job. 

For a job at control point n, the DSD command n . ROLLOUT, xxxx . 
will roll the job out for xxxx seconds. 

The following command to roll a job out for a time period may 
also be used under DIS. 

ROLLOUT, xxxx. 



Description of Timed/Event Rollout 

The timed/event rollout feature allows jobs to access system 
resources as they become available. Through use of the ROLLOUT 
macro, the user may request to be rolled out until an event 
occurs or time period expires. If the desired event does not 
occur within the specified time period, the job is scheduled to 
roll in for further processing anyway. 

To determine when a specified event has occurred, a system event 
table is maintained in MTR's memory. System programs can make 
entries to this table to indicate occurrence of events. Routine 
1SP compares the requested event with the system events recorded 
in this table to determine if any matches have occurred. If a 
match occurs, 1SP initiates roll in. If no one is waiting for 
the system events they are cleared from the table. 



ROLLOUT Macro 

The format of the ROLLOUT macro is as follows 



LOCATION 


OPERATION 


VARIABLE SUBFIELDS 




ROLLOUT 


addr 



addr 



Optional address containing 
further parameters 



60454300 A 



5-21 



If addr is not specified, the job rolls out until the operator 
initiates rollin. If addr is specified, the job is rolled out 
for the specified time and event description. The format of 
addr is as f o I lows . 



59 



29 



11 



cddr 






evd 


rtp 



rt p 



evd 



Rollout time period in job scheduler 
delay intervals CCKrtp<7777B) . If rtp = 
the job rolls out for a time determined 
by the system to insure that the job 
will roll in if the event for which it is 
waiting for is lost or never occurs. 

Event descriptor 



If evd is nonzero, the event descriptor and rollout time period, 
rtp, are placed in the control point area (TERW) . When the job 
rolls out it waits for the occurrence of the event in evd or 
the specified time period (rtp) to elapse before becoming 
eligible for rollin. 

If evd is 0, the event is taken from the control point area if 
bit 30 in TERW is set to indicate a valid event descriptor and 
only the rollout time period is taken from addr. This option 
allows the user to. roll out waiting for events that the system 
speci f i es . 

If evd equals 7700xxB, then extended timed rollout is made. 
(Assume the job scheduler delay is 1 second.) Since the maximum 
time rtp can specify is approximately 1 hour and 8 minutes, the 
-extended time rollout allows the user to roll out for any length 
of time. This is a strict time rollout with no event dependency. 
The job rolls out for (4Q96*xx+rtp) seconds. 

The ROLLOUT macro calls CPM to read the rollout time and event 
from the users field length and store it into control point area 
address TERW. CPM then does a ROCM and control is returned to 
the user. The user then can execute until the rollout bit is 
detected by MTR who initiates 1AJ, who calls 1R0. In order to 
insure the rollout, the user must issue a PP request, since 
CPUMTR will not honor a PP request for a control point scheduled 
for rollout. CPUMTR places the control point in I autorollout 
status with an outstanding RA+1 request. The simplest method is 
to build a dummy FET and issue the RETURN macro. This issues an 
RA+1 request to CIO. 

MTR detects that this control point is in I status and is 
scheduled for rollout and calls 1AJ, who calls 1R0. 



Routine 1R0 rolls the job out 
address TERW. If it is zero, 
is nonzero, then 1R0 builds a 
and time limit from UPCW into 
TERW. 



and then checks control point area 
this is a regular rollout. If it 
TEFT type FNT and places the event 
the FST. Routine 1R0 then clears 



60454300 B 



5-22 



When the job rolls in, MTR finds the control point in I status, 
and an RA + 1 request. MTR calls CPUMTR with a zero request and 
CPUMTR then honors the RA+1 request. In the case of the RETURN 
dummy, CIO treats it as a null operation (file does not 
exist) and terminates. Then the control point can continue. 

Example 1 

An attempted attach results in file busy status. 

Assume error processing is set. Upon restarting the job, use of 
the ROLLOUT macro with evd equals rolls the job out for the 
time specified by ftp, waiting for the event (file ready to be 
accessed) to occur. Routine ORP enters this event in the system 
event table when the file becomes not busy. PFM stored the 
descriptor for this event in the control point area (TERW) when 
it found the file busy but it did not set the rollout flag, 
allowing the user to choose whether to rollout immediately, or to 
process some other function first. 

If error processing is not set the job is automatically rolled 
out, waiting for the file to be ready to be accessed. When the 
job rolls back in, the ATTACH request is retried. 

The event for example 1 is as follows. 
17 11 




When a user attempts to access files that are interlocked, the 
system automatically sets the error flag and terminates the job 
step until the file becomes available (unless the user is doing 
his own error processing). 

The user may bypass this automatic job step abort, by specifying 
the NA option on the ATTACH control statement, so that the job 
step is not aborted if the file is busy. 

The user calling PFM via the macros provided, can avoid job step 
abort by specifying error processing. If error processing is 
specified, the system returns control to the user with error 
status reflecting file busy. 

Example 2 

Suppose that before J0B1 continues processing that it wants J0B2 
(a system origin type job) to execute a certain function. Assume 
J0B1 uses the rollout macro with evd = 1300 and rtp = 600. The 
rollout flag will be set for J0B1 to rollout for 600 seconds or 
until event 1300 takes place. Before the 600 seconds has 
elapsed, suppose J0B2 makes the macro call EESET 1300, entering 
the event 1300 in the system event table. J0B1 will then be 
scheduled for rollin to resume processing. If 600 seconds 
elapse because event 1300 has not occurred (or the event was 
cleared from the table before J0B1 rolled out), J0B1 will be 
scheduled for rollin. 
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In any case, J0B1 does not know if it was rolled in because of 
time or event occurrence. Hence, it is necessary for J0B2 to do 
something; for example, write a code word on a permanent file 
which J0B1 can check to see if the event occurred. 

This job dependency can be accomplished by J0B2 attaching a 
direct access file in write mode and then J0B1 doing the same. 
J0B1 will wait as in example 1 for J0B2 to release the file. 
However, if J0B1 gets the file first, it must release the file 
for J0B2 and then attempt to attach it again. In order to use 
EESET effectively, an installation must change CPM to accept 
other origin types that issue EESET. This solution may cause 
the filling of the event stack. So, a change to CPM warrants 
careful consideration by the installation to limiting the number 
of EESET requests per origin type. 

Examp le 3 

A user requests a magnetic tape with a specified volume serial 
number (VSN) or a removable pack with a specified pack name. 
RESEX, the resource executive which is called to allocate 
magnetic tape and removable pack resources, will effect a 
timed/event rollout if it does not find the specified tape or 
pack mounted. The event used is the sum of the bytes in the VSN 
or pack name, truncated to 12 bits. The equipment portion of 
the event descriptor is 76B, which is equivalent to the 
timed/event EST entry. 

When 1MT reads the VSN from the tape or IMS and MSM initialize 
or recover a removable pack, the matching event is entered into 
the event table in MTR via the EATM function. Routine 1SP then 
detects a match and has the job scheduled for rollin. 



FNT INTERLOCKING AND SCHEDULING 

A transition state is defined to be the state in which a job may 
be in the process of rolling in or rolling out. The concept of 
the individual FNT interlock provides better protection for jobs 
and files that are in a transition state than was previously 
provided by the technique of disabling job scheduling. The 
following paragraphs describe the various FNT interlock 
mechanisms, how they are used to protect jobs and files that are 
in the transition state, and the impact they have on scheduling. 
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INDIVIDUAL FNT INTERLOCK 



FNT entry is accomplished through the 
FNT.- interlock) . This function sets 
for a particular FNT entry. The 
entry is kept in the FNT interlock 
the FNT. The interlock on an 

individual FNT entry should be held for the shortest time 

possible to avoid performance degradation. 



Interlocking an individual 
monitor function SFIM (set 
or clears an interlock bit 
interlock bit for each FNT 
table which is appended to 



This technique is used in the following circumstances: 

• Bringing an input file into execution. 

Performing a job advance. 

Rolling in or rolling out a job. 

Terminating a job. 

Altering the FNT or system sector of a queued file. 

Moving a file from one queue to another. 

Assigning a queue file to a control point. 

The format of the SFIM monitor function is described in the NOS 
Systems Programmer's Instant. 

GLOBAL FNT INTERLOCK 

The FNT may be globally interlocked by the reservation of the 
FNT pseudo-channel (FNCT). The use of this mechanism is to 
avoid conflicts which may occur when more than one system 
routine attempts to update the FST entry of a queued file. The 
global interlock is only used when the contents of queued file 
FSTs are to be altered. This interlock should be used with 
caution as the priority evaluation scheme is disabled by it. 

In cases where the individual FNT inter lock - (SFIM) and global 
interlock (FNCT) are both required, the SFIM interlock should be 
obtained first and then the FNCT channel reserved. This order 
must be maintained to avoid a deadlock situation. 

An example of where the FNCT interlock is used is the DSD 
command ENQP. Routine 1SP i s' periodical ly called to do queue 
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evaluation and updates the priority field in queued 
s. DSD updates the priority field in a queued file FST 
rming the ENQP command. If both DSD and 1SP tried to 
he same queued file FST, a conflict would occur. DSD 
the following sequence to avoid the possibility of 
conflicting ENQP entry. First, the desired FNT is 
ked via the SFIM mechanism. Then the entire FNT is 
ked by reserving the FNCT pseudo-channel. After DSD 
the appropriate information in the F ST , t h e 
hannel is released, clearing the FNCT interlock, and the 
al FNT interlock is cleared using a SFIM monitor 



FNT ENTRY INTERLOCK 

The FNT is also globally interlocked by those system routines 
making new FNT entries by the reservation of the FNT entry 
pseu do -channel (FECT). This mechanism guarantees that a system 
routine may determine where within the FNT to write the FNT/FST 
entry without being disturbed by another system routine making 
FNT/FST ent ri es . 

An example of the use of the FECT interlock mechanism is found 
in routine OBF. Routine OBF obtains the FNT entry interlock by 
reserving the FECT pseudo-channel. The FNT is then scanned for 
an empty position. Routine OBF writes the FNT/FST entry at this 
location and then releases the pseudo-channel, clearing the FECT 
interlock. 

JOB ADVANCEMENT 
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TRANSITION STATE SCHEDULING 

For system routines to properly control transition state 
activity it is necessary to set the FNT interlock on the queued 
file or i nput / ro I lout file being manipulated before any 
transition activity may take place. 
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The following example shows how the individual FNT interlock is 
used during the rollin and rollout transition states. In 
following the example, remember that the same FNT position is 
occupied by the job's rollout (when the job is rolled out) and 
the job's input file (when the job is rolled in). 

In the case of rolling in a user job, the scheduler (1SJ) 
selects the job and then sets the FNT interlock on the rollout 
file before assigning it to a control point. During the rollin 
process, 1RI replaces the FNT/FST entry for the rollout file with 
that for the job's input file and sets this FST address into 
TFSW. When 1 R I requests the job to be advanced, the FNT 
interlock is cleared. 

In the case of rolling out a user job, the rollout request (ROCM) 
issued by the scheduler causes the job advance flag to be 
checked. If the FNT interlock (on the input file)' is already 
set, the job advancement is requeued for reissuing. If the 
conditions for job advancement are met and the FNT interlock is 
not set, both the FNT interlock on the input file (as determined 
through the TFSW entry) and the job advance flag are set, and 
1AJ is called. Then 1 A J calls 1R0. Routine 1R0 writes the 
rollout file FNT/FST entry at the address specified by TFSW and 
issues a JACM function to clear the job advance flag, the FNT 
interlock (which is now on the rollout file), and selected 
control point area words including TFSW. 

With the individual FNT interlock structure, system routines are 
able to identify when transition states are completed by the 
successful issuance of their own FNT interlock request. This in 
turn prohibits a transition state from occurring while they 
perform their specified function on that job or queued file. 



SPECIAL PROCESSING 

This section overviews the processing of subsystems, special 
entry point jobs, and special RA+1 requests. 

SUBSYSTEMS 

A subsystem is a special type of job with many privileges not 
granted to user jobs within the system. Some of the 
characteristics of a subsystem are: 

• Cannot be rolled out except in system checkpoint 
s i tuat ions . 

• Can make use of the intercontrol point communication and 
special RA+1 requests (SIC and RSB) for receiving and 
sending data buffers. 

• Can get a CPU priority above user jobs. 

• Need not be restricted by JCB or VALIDUs; however it must 
have a user index set in UIDW, in order to access 

pe rmanent f i les . 
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• May elect to run at a specific control point. 

• Has an implicit special entry point (SSJ=) status. 

• Can request the CPUMTR to load a PP routine whose name 
begins with a numeric CRA+1 call SPC) . (Any PP request 
from a normal job must be for a PP routine whose name 
begins with a letter. Any other PP call aborts the CPU 
program.) 

In order for a job to qualify as a subsystem, it must satisfy 
each of the following requirements. 

• Have a queue priority greater than LSSS (defined in 
NOSTEXT) and have a byte for it in the SSCL words in CMR. 

• Have an entry defined in 1DS so that it can be called 
from a DSD command. 

• Have a unique queue priority, since it interacts with the 
system based on its queue priority and not on its user 
index, name, or control point number. 

The current subsystems and their queue priorities are described 
as fo I lows . 



Subsystem Symbo I 

Deadstart Sequencing 
Time-sharing (TELEX or IAF) 
Remote Batch (EI200) 
Unit Record (BATCHIO) 
Magnetic Tapes (MAGNET) 
Transaction (TAF/TS,TAF/NAM) 
Time-sharing Stimulation 

(STIMULA) STPS 

Network Interface 

Processor (NIP) NMPS 

Remote Batch Facility (RBF) RBPS 
CYBER Data Management 

Control System (CDCS) CDPS 
Message Control System (MCS) MCPS 
Mass Storage Control (MSM) MSPS 



Queue Priority 



DSPS 


7777 


TXPS 


7776 


EIPS 


7775 


BIPS 


7774 


MTPS 


7773 


TRPS 


7772 



7771 

7770 
7767 

7766 
7765 
7764 



Subsystem Startup 

A subsystem has a PP program that initializes the subsystem. 
For example, TELEX has 1TD; MAGNET, 1MT; EI200, 1LS; and so 
forth. In many cases, the PP program is also the driver for the 
subsystem in addition to performing its initialization. As an 
example in this discussion, the initialization of the remote 

batch facility (RBF) subsystem is used. The PP. routine 1 S I 
performs the control point initialization for RBF (as well as 
several other subsystems). 

The jobs for subsystem initialization are entered into the input 
queue by 1DS functions 32 and 33. Function 33 is used when the 
subsystem is activated by default when an AUTO, is done; 
function 32 is used when the subsystem is activated by entering 
the DSD command for the individual subsystem. Routine 1DS 
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maintains a table of parameters from which the FNT/FST input 
queue entries for the subsystems are built. An entry in this 
table has the following format. 



byte 



byte 1 



byte 2 



byte 3 



byte 4 



qp 


pp 


cp 


sm 


sb 



qp 
PP 

cp 

sm 

sb 



Subsystem queue priority as described previously 

Name of the PP processor that performs the 

subsystem control point initialization 

Relative control point number required by the 

subsystem 

Mask bit setting (12 bits) that corresponds to 

the subsystem enabled/disabled bit for the 

subsystem in SSTL 

Byte in SSTL to which sm applies 



Subsystems have a requirement to reside at a given control point 
in order to minimize the system overhead used by the subsystem 
(for example, never storage moved). The number 1 for cp 
indicates that control point 1 is required; 2, control point 2 
required; and so on. If cp is greater than 4QB, the required 
control point is determined as the system control point minus 1 
minus the complement of cp. Thus, the value 77B indicates that 
the last control point is required; 76, last control point minus 
1 is required; and so on. If a Tollable job is at the control 
point, it is rolled out so that the subsystem may have the 
control point it requires. 

The following octal values are referenced through the symbol 
IASD. 



Subsystem 


qp 


PP 


cp 


sm 


sb 


TELEX/IAF 


TXPS 


1TD 


1 


2000 




EI200 


EIPS 


1LS 


77 


1000 




BATCHIO 


BIPS 


1 10 


76 


4000 




MAGNET 


MTPS 


1MT 


75 


0400 




TAF/TS 


TRPS 


1TP 


2 


0200 




TAF/NAM 


TRPS 


1SI 


2 


0004 




NIP 


NMPS 


1SI 


74 


0002 




RBF 


RBPS 


1SI 


73 


0001 




STIMULA* 


STPS 


1TS 


77 


0000 





Mass Storage* 


MSPS 


CMS 


74 


0100 


1 


CDCS 


CDPS 


1SI 


71 


1000 


2 


MCS 


MCPS 


1SI 


72 


2000 


2 


Deads tart* 


DSPS 


SET 


1 


0000 






When 1DS is called to issue the subsystem initialization jobs 
through an AUTO, or an individual subsystem DSD command, such as 
TELEX, or n.RBFffff., it builds an FNT/FST entry using data from 
this table. The FNT/FST produced as the result of an n.RBFffff. 
command would have the following format. 



*Not initiated via AUTO. 
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59 


53 


47 


41 


35 




17 


11 


5 


1 


. SI 
(PP) 


cp 


sn 


SYOT 
(jot) 


INFT 
(ft) 








77 


ffff 


fl 


RBPS 
(qp) 



PP 

cp 

sn 

j ot 

ft 

ffff 

fl 

QP 



Controlling routine 

Control point required 

Job sequence number 

Job origin type 

Fi le type 

Procedure file sequence number 

Fi eld length 

Queue priority 
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When the control point becomes available, it is assigned to the 
subsystem. The control point number is entered in byte 4 of the 
FNT entry and in the subsystem control word. Protective coding 
prevents a subsystem from requesting a control point which is 
not defined in the system. The control point area is then built 
with all limit values set to un I i mi ted/ i nf i ni t e . 

The control statement pointer (CSPW) is set to indicate an EOR 
on the input file. Default family information is set into PFCW 
and the family count incremented. The subsystem's queue 
priority and a CPU priority of MRPS-2 are set in JCIW. The 
procedure file sequence number is set in CSBW for use by 1SI. 
The exit mode 7007 is set in the control point exchange package. 
The scheduler active bit is cleared from' JSCL+1 , the FNT 
interlock cleared, and the job name written into this PP's input 
register with an exit to PPR so that the PP program to 
initialize the subsystem is loaded. 

Once the PP program is loaded into this PP, it initializes the 
control point field length, and so on, to fit the requirements 
of the subsystem, set up a control statement stream or procedure 
file call (for TAF, NIP, RBF), and call 1AJ to process the 
control statement stream which brings the subsystem into 
execut ion . 
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SPECIAL ENTRY POINTS 

Many system operations can be performed more efficiently by a 
CPU routine rather than a PP routine. However, normal CPU 
routines are restricted by the system from accessing system 
information. To allow CPU routines to perform restricted system 
operations, special entry points are used. That is, a CPU 
routine using special entry points can access restricted system 
information such as CMR. All special entry points are 
three characters in length followed by an equal (=) sign. 

The special entry points available are the following. 



Special Entry Point 

ARG = 

DMP = 
RFL = 
MFL-- 
SDM = 

SSM = 
SSJ = 
VAL = 



Desc r i pt i on 

Suppress arguments processing (RA + 2 

through RA+63) 

Dump (save) previous job before load 

Automatic FL specification for load 

Minimum FL specification for load 

Suppress control statement day file 

message 

Secure system memory 

Special system job specifications 

Define job as a validation processor 



A CPU routine with any of the preceding special entry points 
defined is handled specially by SYSEDIT. That is, SYSEDIT 
appends an extra word (SEP A) to the CLD entry for this routine. 
This word is a condensed version of the special entry points 
defined in the routine and are used by 1AJ when the routine is 
loaded. The format of SEPA is as follows. 



SEPA 



59 


17 


flags 


sa 



flags 



Each bit set indicates the following. 



Bit 

59 

58-54 

53 

52 

51 

50 

49 

48 

47-36 

35 

34 



Desc ri pt i on 



Indicates special entry point table entry 

Ze ro 

ARG = 

DMP = 

SDM = 

SSJ = 

VAL = 

SSM = 

Ze ro 

Restart ro 1 1 i n 

Ze ro 



entry point present 

entry point present 

entry point present 

entry point present 

entry point present 

entry point present 
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Bit 



Desc ri pt ion 



33 

32 
31 

30 
29-18 



Suppress DMP= on control statement call 

Only create DM* with nothing on it 

Dump FNT entries, control point area and 

field length, to file DM* 

Create file DM* as an unlocked file 

0/ for dump of full FL; nonzero for dump 

FL* 100B of FL 



of 



sa 



SSJ= parameter block address 



All normal ABS entry point 
59 of SEPA equal to 0. 



names in the CLD will have bit 



Routine TAJ detects the SEPA word and processes the load 
accordingly. System routines that are called via special 
entry points include CHKPT, CPMEM, and RESEX. These routines can 
be called from a PP or via an RA+1 request summarized as follows. 



RA + 1 
Request 

CKP 
DMP 
REQ 
LFM/PFM 



PP Request 
Processor 

SFP 
SFP 
SFP 
LFM/PFM 



CPU Request 
Processor 

CHKPT 
CPMEM 
RESEX 
RESEX 



Description 

Checkpoint request 
Dump FL 

REQUEST macro call 
Tape/pack request 



These CPU routines can be called by an RA+1 request or by another 
PP routine. (When RA + 1 is used to make the call, auto recall is 
designated.) The routine names CKP, DMP, and REQ must not be in 
the PP library since these calls are processed by SFP. In order 
for the PP request processor (SFP, LFM, or PFM) to call the CPU 
routine, the entry point name (which is the same as the RA+1 
request) is placed in SPCW in the control point area. The PP 
request processor can perform the following. 

• Set any completion or status bits in the requesting jobs 
FL. 

• Set bits 38, 39, and 40 of SPCW as desired. 

• Write its own PP input register image in RA+1 so that 
this PP routine is called upon completion of the CPU 
rout i ne. 

• Set rollout flag (ROCM function). , 

Routine 1AJ picks up SPCW and loads the appropriate CPU routine 
for the specified entry point name. The upper six bits of SPCW 
are used as an interlock to prevent more than one call at a time 
from being processed. This means that one routine using special 
entry points cannot call another such routine. The upper six 
bits of SPCW are equal to 77B if such a routine is active. The 
CPU request processor contains entry points for the system 
function desired. For instance, RESEX has entry point names REQ, 
LFM, and PFM. When the PP request processor has completed 
setting up SPCW, it drops and 1AJ continues the processing. 
Routine 1AJ rolls out the calling CPU routine (filename is DM*) 
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RA+3 
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pa ram 

Now t 

p r i a t 
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s sta 



oint exists for the CPU request processor 
ded. If a parameter block address has been 
SPCW word, 1AJ picks up the parameter List and 
OB through RA+47B. The SPCW word is stored in 
defined by symbol SPPR), as shown in figure 
vailable only if DMP= has been specified.) 
eter list will be available to the CPU request 
he CPU routine is loaded and processing begins 
e entry point. Prior to normal termination, 
ocessor can set a return status in RA+27B 
tus is later stored in bits 35 through 24 of 



When 1AJ detects that the CPU request processor has completed, 
it calls 1RI to perform the following. 

Store the return status in SPCW. 

Retrieve the parameter block from RA+3QB through RA+47B. 

Reload the control area and job's FL from the DM* file, 
if it exists. 

Store the updated parameter block back into the job's FL 

Clear SPCW word. 

Routine 1AJ now restarts the original calling program where it 
left off. 
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RA+O 
RA + 1 



(SPPR)RA+27 Q 
RA+30q 



RA + 47, 



8 



(PGNR) RA+64 8 



20B word parameter block 
stored here (if program requires 
more than 20B words, it must 
read the DMP file DM*). Only 
available with DMP = special 
entry point. 



- Contents of SPPR stored 
here when loading CPU 
processor. CPU processor 
may put a status in byte 
2 for return to the PP 
calling program. 



Cleared to indicate call 
was initiated by a PP- 
request processor (other- 
wise nonzero indicates 
normal control statement 
initiation). 



Figure 5-11. Field Length of Loaded CPU Request Processor 
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ARG= Special Entry Point 

ARG= is used by a job wishing to do its own control statement 
argument processing. If present, arguments are not passed to 
RA+2, but the entire control statement image, including statement 
label and other options ($,/), is placed in RA+70. 



DMP = Special Entry Point 

A program using the DMP = entry : point should set up bits 35 
through 18 in SEPA with a PP routine (in the case of the control 
statement or macro DMP it is done automatically) as previously 
desc ri bed. 

The DM* file is the rollout file. The only difference is in the 
FNT. If it were a rollout file, then the FNT would be as 
follows. 



59 



17 



11 



job name 


job 
org 


type 
ROFT 


cp 
= 



However, as a DM* file the FNT would be as follows and the file 
remains attached to this control point. 



59 



17 



11 







DM* 


job 
org 


type 
LOFT 


cp 
no. 



DM* is not a legal file name and a CPU user cannot create a file 
whose name contains special characters. However, a CPU routine 
may read or write such a file if it already exists. Hence, 1R0 
must be asked to create the DM* file if a special entry point 
job needs to use the file. 

The flow of a DMP= request is as follows. 

• 1AJ finds this control point idle. That is, W = X = R = 
or DIS calls 1AJ directly. 

• 1AJ calls 1R0, which creates a rollout file as specified 
in bits 35 through 18 of SEPA. The file will be named DM* 
and left attached to the control point as a local file. 

• 1AJ then loads the CPU program containing the entry point 
name specified in SPCW. 

• The CPU processor completes normally (END or ABT). 

• 1AJ is called to advance the job; it detects that a DMP= 
has just completed and calls 1RI to restore the control 
point FL and control point area from the DM* file. 

• 1AJ advances the job or restarts the previous job. 
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Figures 5-12 through 5-14 illustrate the DMP = processing while 
figures 5-15 through 5-21 illustrate the flow charts for this 
procedure, using DMP as a example. 

RFL= Special Entry Point 

When a program with RFL- is loaded from the system, the 
program's field length is set to the value of RFL = (rounded to 
the next higher 100B) . 

MFL= Special Entry Point 

Same as RFL= except nothing is changed if the RFL (as set by the 
last RFL control statement or by the last SETRFL macro call) is 
greater than the MFL = value (if present RFL> MFL = , then use 
present RFL value). 

SDM= Special Entry Point 

For programs with SDM= entry points, no dayfile message is 
generated on the control statement call. The program should 
issue its own messages. Using ACCFAM as an example, the 
password on a USER statement should not appear in the dayfile. 
When USER,ABCUSER,PASSWRD. is issued, ACCFAM using an SDM= entry 
point can strip off the password and issue USER, ABCUSER,. to the 
dayfile. 
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Step 1 (temporary rollout) 



RA 



FL 



Control point area 



FNT/FST 



Job field length 



System 




Figure 5-12. DMP=* Processing (1AJ Calls 1R0) 
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Step 2 (DMP S job load and execution) 



Control point area 



FNT/FST 



RA 



FL 



Job field length 



System 




Figure 5-13. 1AJ Calls LDR to Load DMP= Program 
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Step 3 (rollin DM* file) 



RA 



FL 



Control point area 



FNT/FST 



Job field length 



System 




Figure 5-14. 1AJ Calls 1RI to Restore the Job 
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^ control >- 
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search 
CLD 




"N. statement,/ 






^yyes 
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setup LDR 
to load 
CPMEM 


load 
routine 
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> 














executive 
loaded 



Figure 5-15. General Flow 
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process 
control 
statement 



CPMEM has 
a DMP = entry 
point u — 



Previous job 
was not DMP = 



Crack control statement 
DMP (X, Y) 




this is not 
no a DMP = job 
yet 



Find DMP 
as a 
part of 
CPMEM 



Figure 5-16, Pass 1 (Job Flow Has Come to a DMP 

Control Statement) 



60454300 A 



5-38 




1R0 has not 
been called yet 




Fi gure 5-17. Pass 2 
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yes 
1 RO was called 
last time 



process 
control 
statement 



TCS has a trap for DMP = already 
found so it doesn't crack the 
control statement again. 



We called 
1R0 in the 
last pass 




load 
routine 




F igure 5-1 8. Pass 3 
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CPMEM has completed, job needs to advance to next 
control statement 





TCS uses DMP = last control statement in preset and 
does not crack the new control statement 




Figure 5-19. Pass 4 
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®~ 



process 
control 
statement 



This time TCS cracks the new control 
statement Preset knows that 1 Rl was called 
and we are now ready to get the new 
control statement. 




Load routine 
which may not 
have a DMP = 
entry point* 



*1 A special entry point job cannot initiate another special 
ent ry po i nt j ob 

Figure 5-20. Pass 5 



60454300 A 



5-42 



SSJ= Special Entry Point 
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The common deck GOMSSSJ is provided to supply the calling 
program with special system job parameter equivalences. 

An RFL= entry point must precede the SSJ- entry point to allow 
SYSEDIT to verify that the parameter area fits within the 
special system jobs field length. If this condition is not 
satisfied, the SSJ= entry point is considered a normal entry 
point for the program and no special processing will be done for 
it. The only acceptable order is: 



ENTRY 
ENTRY 



RFL = 
SSJ = 



The first word of the parameter area CSPPS) is used to set the 
control point area values. If it is zero, the current values 
are retained. Limits for these values are: 

<_ CPU priority < 70B 

< queue priority < MXPS+1 

< time limit < 77777B 

Any other values are ignored. Thus, it can be ensured that a 
task does not get a time limit error, that a task has a higher 
CPU priority than a normal job, and so on. Values are reset when 
the task terminates. 
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The SSJ= parameter block format is as follows. 



SPPS 
UIDS 
ALMS 
ACLS 
AACS 



59 




47 




23 


17 


11 








time limit 


CPU 
priority 


queue 
priority 


user number 


user index 






exact copy of control 


point area word ALMW 








exact copy of control 


point area word ACLW 








exact copy of control 


point area word AACW 





The entire SSJ= block is swapped with the control point area 
values unless word is zero. If word is zero, then just 
store the user's control point area in the 5-word block. In any 
case, when the SSJ= completes, the 5-word block is restored into 
the user's control point area. Thus the SSJ= program can and 
does place any values it sets in this block into the control 
point area. 

That is the way that ACCFAM sets up the user verification area 
in the control point area, and the way that CHARGE clears the 
VAL= flag (bit 17) in UIDW. Also, the swap allows the SSJ= 
program to specify UI = 377777B for accessing validation, 
accounting, and resource files. If the SSJ= user defines SSJ= as 
0, then the swap does not occur, and all files created by the 
SSJ= user do not get ID = 74B. The files remain for the caller, 
but the job gets S S J = privileges (SIC, RSB, and so on). 

VAL= Special Entry Point 

When validation is enabled, the system aborts any job of 
nonsystem (SYOT) origin which attempts to load and execute as 
the first control statement, any routine which does not have a 
VAL= entry point. This is the method employed to check 
validation. The first two or three statements of a job stream 
must be job, USER, and CHARGE (if needed). USER causes the 
loading of ACCFAM, and CHARGE causes the loading of CHARGE, both 
of which contain VAL= entry points. The system allows these 
routines to run, and assuming that they do not abort the job, 
they enter this job stream into the system. Once they are done, 
the VAL= system checking is no longer done for this job. If a 
user did not have a USER statement as the second statement, it 
forces a load of a routine without a VAI_= entry point, and the 
job is aborted by the system. 
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SSM= Special Entry Point 

The SSM= entry point causes the secure system memory status to 
be set in the control point area. The setting of the secure 
system memory bit (bit 59 in DBAW) prevents the dumping of any 
portion of the job's field length. 

SPECIAL RA + 1 REQUESTS 

The following RA+1 requests can be used only by a subsystem. 



SIC 
RSB 
SPC 



SIC and RSB can also be used by SSJ= or queue priority greater 
than MXPS type jobs. SPC is used to call special PP routines. 
SIC and RSB are used for intercontrol point communications. 

Special PP Calls 

A normal CPU routine may request only PP routines whose name 
begins with a letter. This is a protective feature to keep 
normal jobs from accessing certain system PP routines. By 
convention, any PP routine which should be available to a user, 
and is coded in such a way as to keep from destroying the system 
if called by an improper request, has a letter as the first 
character of its name. Other restricted PP routines have a 
number as the first character their names. 



The SPC request allows a CPU routine to call 
routine (such as IAF or TELEX calling 1TA). 
as f o I lows . 



a special PP 
The SPC request 



i s 



59 



RA + 1 



41 



17 



SPC 





addr 



addr 



First word address of a list of names of the 
PP routines desired and their arguments. The 
list is terminated by a zero word. 



In a SPC request, the following conditions apply. 

• Autorecall is not honored. 

• If the addr word is cleared, the request has been honored 
and the PP routine started. 

• If the addr word is unchanged when the CPU regains 
control, the PP routine was not started (possible PP 
saturation, for example. 

• The call is honored only for jobs whose queue priority is 
greater than MXPS. All other job steps are aborted. 
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The format of Location addr is as follows. 



59 



addr 



41 



35 



PP routine 
desired 





arguments 



Intercontrol Point Communication 

The control point concept allows each control point to run 
independently of any other control points in the system. In 
addition each control point is protected from any other control 
point destroying any part of its field length. In some cases, 
however, it is necessary for one control point to communicate 
with another, as in TELEX to TAF/TS, and RESEX to MAGNET. 

A subsystem or any program with SSJ= or a queue priority greater 

than MXPS wishing to communicate with some other control point 
(maybe another subsystem) by sending information, can set up a 

communication block using ICAW in the control point area and 

transfer it to a designated control point. Also, it may receive 

a block of data from some other control point (which may also be 
another subsystem). 

The control of the transfer is based on the subsystem's queue 
priority (which is why they must be unique). The buffers are 
defined in ICAW. The SIC and RSB RA+1 requests are used for 
this communication. 



SIC Request 

The SIC request is used to send an intercontrol point data block 
from a control point program to the specified subsystem. The 
format of the request is as follows. 



59 



RA+1 



40 35 



17 



/ 


/ 








sic ; 


c- 





buff 


St 



r 1 if autorecall is desired (bit 40) 
buff First word address of the buffer to be 

transferred to the subsystem 
st Address of status word for the transfer 



The format of location st is as follows, 
st 



59 




41 




29 





bn 


sqp 


W^, 


WW^/s 



bn 
sqp 
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Buffer number of subsystem to transfer to 
Destination subsystem queue priority 
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A block starting at buff wilt be moved to the indicated 
subsystem. The block length is specified in bits 17 through 
of the first word of the block (buff), which includes this 
header. The block length must be less than 101B (to force 
CPUMTR in MTR mode; this operation must be very fast). 

NOTE 

The request is honored only from jobs with 
queue priority greater than or equal to MXPS 
(subsystem status), or an SSJ= entry point 
defined, or with access bit CSTP (user may 
access special transaction functions) turned 
on. If these conditions are not met, the 
call is treated as a call for a PP routine. 
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After the request is processed, Location st has the following 
format . 



59 



st 



41 



29 







bn 


sqp 


reply 



bn Unchanged 
sqp Unchanged 
reply 1 If transfer completed successfully 

3 If designation subsystem is not present in 

t he system 
5* If subsystem buffer is full, subsystem being 

moved, or subsystem job is advancing 
7 If block length as specified in the first 
word is larger than that permitted by the 
subsy s tern 
11 If destination buffer is undefined by the 
subsystem 

The format of the buffer block to be transferred is as follows. 



59 



11 







buff +0 



+ 1 



+2 







block length 
= n + 1 



1st data word 



2nd data word 



+ n-1 



+ n 



n-1 data word 



nth data word 



NOTE 

n is less than or equal to 1 OOB so entire 
b lock length is 101B . 



*If autorecall is specified, the control point remains in recall 
until condition 5 ends. The subsystem may indicate whether its 
buffer is full by setting the first word in the buffer nonzero. 
That is, if the first word of the buffer in the subsystem is 
nonzero it cannot receive data; if it is zero, it is ready to 
receive dat a . 
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RSB Request 



The RSB request is used to send an intercontrol point block from 
a subsystem to the calling control point; if no subsystem is 
specified, from absolute CM. The calling routine must have an 
SSJ= entry point defined. 



The format for this call is as follows. 
59 40 35 29 

RA+1 



17 



/ 



RSB 



m 



sqp 



st 



r 
sqp 



St 



1 if autorecall desired (bit 40) 

Subsystem queue priority (or control point to 

read). If zero, then block is read from 

absolute memory or relative to caller's control 

poi nt area . 

Address of status for the read. 



The format of location st is as follows. 



st 



59 




47 




35 




17 










wc 


addr 


buff 



wc Number of words to read. 

addr Address to read from CM or buffer address 
relative to the subsystem. 

buff Address of buffer to receive data in this 

control point's field length. When sqp = 0, 
contents of buff determines whether the read 
from absolute CM or relative to the caller's 
control point area. 



the 
i s 



If buff is less than 0, the read is 
the st word is the absolute address 



from absolute CM and addr 
in CM to begin the read. 



i n 



If buff is zero or greater, the read is relative to the caller's 
control point area, and buff contains a list of addresses 
located within the control point area which are to be read. The 
list ends at wc or a zero list entry. The contents of the 
control point area address read is stored in the buff location 
which contains that address. 

Location buff is a flag denoting a read from absolute memory or 
relative to the control point area in the case where sqp is 0. 
The calling program must have an SSJ- entry point. 



60454300 A 



5-49 



After the request is processed, the format of Location st is as 
f o L Lows . 

59 47 35 17 



st 



reply 


wc 


addr 


buff 



repLy 4000B Transfer compLeted successfully 

2000B Subsystem not present 
wc Unchanged 
addr Unchanged 
buff Unchanged 

If sqp is nonzero, the buffer is filled. If sqp is zero and 
buff is less than zero, buff is filled from absolute memory as 
specified in the addr field. If sqp is zero, and buff is 
greater than or equal to zero (control point area read), then an 
example of this format is as follows. 

59 



buff +0 



+ 1 



+ 2 



+ 1 



STSW 



STSW-17B 



+ WC-2 



+ WC-1 



MS1W 



APJW 



In the preceding example, buff+1 contains the job status word 
from the control point area; buff+2 contains the second word of 
the exchange package area (from the exchange package area); 
buff+wc-2 is the first message buffer area; and buff+wc-1 is the 
program number area. 

NOTE 

The buffer's length is wc words. It is not 
possible to get the first word of the 
exchange package area since the address would 
be relative to the control point area and 
any word ends the list. It would be 
necessary to know the absolute address of 
the control point area to get the first word 
of the control point area. 

The above is an example and is not intended to imply that only 
the control point area shown can be read. 
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JOB FLOW 



System job f Low 
1R0, and 1 R I . 



is controlled by routines 1SJ, 1SP, 1AJ, 1 C J , 



JOB SCHEDULER - 1 SJ 

The job scheduler (1SJ) scans the FNT/FST entries looking for 
files of type input (INFT) or type rollout CROFT). It builds 
tables which it uses to determine which of the jobs in the input 
or rollout queue based on priority are to be assigned to a 
control point and started (Table 6-1). Routine 1SJ rolls out 
any jobs which have a lower priority and attempts to start the 
best job. If 1SJ cannot find a best job to start or cannot get 
enough resources for the best job, it drops. 

The next time 1SJ is called, the best job may not be the same 
one picked the last time. A best job is only guaranteed a 
startup if the resources necessary are available at the time the 
job is being prepared. 

Routine 1SJ works with the current system status. Whenever many 
jobs make changes, these changes affect 1SJ only while it is 
executing. The JSCL and JSCL+1 words ensure that only one 1SJ 
can run at any time in the system. The scheduler cycles itself 
until no jobs remain to be scheduled or a certain mass storage 
activity threshold is reached. This ensures that the system is 
not constantly scheduling jobs in and out and thereby wasting 
computer resources. 

The scheduler selects the candidate by using the subroutine 
Search For Job (SFJ). The selection is done on the following 
basi s . 

1. The highest priority job that will fit in unassigned or 
rolling memory within the service constraints FL 
(maximum individual job field length), FLE (maximum ECS 
field length), and AM (maximum memory allowed) for the 
candidate's job origin type. 

2. If candidates of equal priority are found, the job 
selected is the one residing on the mass storage device 
with the least amount of activity. The amount of disk 
activity is determined by the following factors: 
channel busy; channel being requested; and unit 
reservat i on. 

3. If the mass storage activity is also equal, the job 
with the largest field length is selected. 

4. If no job is selected, but one was rejected due to 
service constraints, it may be scheduled if no jobs 
have to be rolled out. If this is done, the job's 
priority will be set to its origin type's lower bound. 
This prevents resources from sitting idle during 
periods of low activity. 
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TABLE 6-1 



1SJ TABLES 



Locat ion 



Description 



Bits 

11 

10 

9-5 
4-0 



1 1 
10 

9-0 



11-0 



11-0 



Desc ript i on 

Ro I Lout i n process 

Rollout requested (used 
in subroutine CFL only) 
Ze ro 
Control point number 



Rollout in process 
Ro L lout requested 
(used in CFL only) 
Ze ro 



Field length assigned 
at cont ro I poi nt 



ECS field length 
assigned at control 
poi nt 



Priority of job 



Origin type of job 



TACP 



TRST 



TJFL 



TJEC 



TJ JP 



TJ0T 



TMF0 



TME0 



Active cont ro I 
poi nt s . One-wo rd 
entry terminated 
by zero entry. 
Sorted in 
descending 
priority. 

Table of rollout 
status. One-word 
entry indexed by 
cont ro I poi nt 
number . 

Job field length . 
One-word entry 
indexed by control 
point number. 

Job ECS field 
length. One-word 
ent ry i ndexed by 
control point 
number. 

Job priority. 
One-word entry 
indexed by control 
point number. 

Job origin type . 
One-word entry 
indexed by control 
point number. Set 
only if job active 

Table of total 
ava i lab le field 
length for all 
jobs of an origin 
type. One-word 
entry indexed by 
origin type . 

Table of total ECS 
avai lab le fie Id 
length for all 
jobs of an origin 
type. One-word 
entry indexed by 
origin type. 



11-0 



11-0 



11-0 



11-0 



Field length available 



ECS field length 
avai lab le 
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TABLE 6-1 



1SJ TABLES (CONTINUED) 



Location I 



Desc ri pt ion 



I Bits | 



Desc ript i on 



TAFO 



TAEO 



TMJO 



TMXO 



Table of assigned 
field length by 
origin type. 
One-word entry 
indexed by origin 
type. 

Table of assigned 
ECS field length 
by origin type . 
One-word entry 
indexed by origin 
type. 

Table of maximum 
field length per 
job by origin type. 
One-word entry 
indexed by origin 
type. 

Table of maximum 
ECS field length 
per job by origin 
type . One-word 
entry indexed by 
origi n type. 



11-0 



11-0 



11-0 



11-0 



Field length assigned. 



ECS field length 
assi gned 



Maximum FL allowable 
for a job 



Maximum ECS field 
length allowable for 
j ob 
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TABLE 6-1. 1SJ TABLES (CONTINUED) 



I Locat ion | 



Desc ri pt ion 



Bits | 



Desc ri pt i on 



DACT 



Devi ce act i vi ty 
count table. 
One-word entry 
indexed by 
equipment number 




Devi ce activity as 
found in byte of MST 
word DALL 



The scheduler is requested periodically or on a demand basis 
through the RSJM monitor function (refer to section 3). CPUMTR 
determines if the scheduler is active (bit 59 set in JSCL+1) and 
if so, takes no action. If the scheduler is not active, 1SJ is 
called unless the scheduling delay in JSCL has expired. In this 
case 1SP is called. Routine 1SP calls 1..SJ into its PP when it 
has finished its tasks. 

The RSJM function is issued when jobs are placed into the input 
or rollout queues (by QFM, 1RD, or 1TA), when a job is started 
(by 1AJ), and by certain routines when it is desirable to begin 
scheduling activities after they have completed (1CK, 1DS, 1MB, 
1 SP, and 3SA) . 

The call to 1SJ has the following format: 



59 



RA+1 



41 



35 



1SJ 


c 


cp 






cp 



Control point number 



A flowchart of the main loop of 1SJ (SCJ), is shown in figure 
6-1. The main subroutines of 1SJ are described in the following 
paragraphs . 
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buiid 
TAFO table 
and TAEQ table 



SCS 



set control 
point status 



set 

available memory 

in ACML 



job at ^ no 
JIP requesting FL 
increase 




SJC 



set job control info 
Jn TMJO, TMFO, TMEO, 
and TMXO 





clear schedular 

active interlock 

in JSCL + 1 



DPPM 



drop PPU 



T 

(pprJ 




set number of 
control points (IMC) 



read 

schedular control 

from INWL 



return 



Figure 6-1- 1SJ Main Loop SCJ 
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CMR 

clear memory 
request 



(SCJTJ 



re-enable 
rollouts 



ra 



Figure 6-1- 1SJ Main Loop SCJ (Continued) 
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•1 The job in queue condition tells 1SJ if it is trying to 

schedule a job to a control point or attempting to increase a 
running job's field length 



Figure 6-1. 1 S J Main Loop SCJ (Continued) 



60454300 A 



6-7 



SET CONTROL POINT STATUS (SCS) 

SCS builds the TACP, TJFL, TJEC, TRST, TJOT, TJPR, TAFO, and TAEO 
tables from information contained in the control point area. It 
initializes direct cells AC (available control points), AM 
(available CM), AE (available ECS), RM (rollout CM), RE (rollout 
ECS), JC (control point with field length request), JF or JE 
(amount of CM or ECS JC requires), and JP (queue priority of JC). 



SET JOB CONTROL (SJC) 

SJC builds the TMJO TMXO, TMEC, and TMFO tables from the job 
cont ro I area . 



DETERMINE DISK ACTIVITY (DDA) 



DDA bui Ids the 
count as found 



DACT table, 
i n byt e of 



DACT is the device activity 
MST word DALL. 



SEARCH FOR JOB (SFJ) 

SFJ chooses the best candidate for scheduling. If on the first 
pass in SFJ no candidate was selected and if a job had been 
rejected because of service constraints, the TMJO, TMFO, TMXO and 
TMEC tables are set with unlimited values, rollout disallowed, 
and a second pass through SFJ made. SFJ is flowcharted as figure 
6-2. 



COMMIT FIELD LENGTH (CFL) 

CFL' selects which jobs need to be rolled out in order to obtain 
the required amount of field length. All jobs necessary to be 
rolled will have a ROCM set for their control point. Jobs of 
the same origin type will be rolled before jobs of different job 
origins, if possible. 

COMMIT CONTROL POINT (CCP) 

CCP selects the control point for the job. If no control points 
are available and none are currently being rolled, a control 
point with a lower priority is selected to be rolled out and a 
ROCM isued on that control point. If control points are 
available, the control point selected is determined as follows 
(consider the control point's field length to include the field 
length of all unoccupied control points following it). 

1 . Exact f i t 

2. Smallest hole that is larger than needed 

3. Largest hole if none is big enough 
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This selection process minimizes the amount of storage movement 
necessary to give the control point the required field length. 

ASSIGN JOB (ASJ) 

ASJ requests the storage for the job, i ni t i a I i zes the JNMW and 
TFSW control point words, sets queue priority and time slices in 
JCIW and TSCW, and calls 1AJ or 1RI to process the job. Routine 
1AJ is called if the job is scheduled from the input queue and 
1RI is called if the jos is scheduled from the rollout queue. 
If a PP is available, a RPPM call is made for 1AJ or 1 R I - If a 
PP is not available or one is not assigned, the scheduler active 
bit (bit 59 in JSCL+1) is cleared and this PP is used for the 
1AJ and 1RI processing. 

SCHEDULE SPECIAL SUBSYSTEM CSSS) 

SSS is contained in overlay 3SA and is used to schedule jobs 
whose queue priority is larger than LSSS, The FNT/FST entry and 
the three subsystem control words SSCL, SSCL+1, and SSCL+2 are 
read. If the byte in the SSCL word for this subsystem is 
nonzero, then the subsystem is already active and all interlocks 
will be cleared and the PP dropped. If the subsystem control 
byte is zero, then the required control point must be assigned 
for this job. If the requested control point is occupied by a 
lower priority job, the job. will be rolled so that the control 
point can be used by the subsystem. If the job at the control 
point is of larger priority than the subsystem, the subsystem 
will use the next available control point. When the control 
point becomes available, it is assigned to the subsystem. The 
control point number is entered in byte 4 of the FNT entry and 
in the subsystem control word. Protective coding prevents a 
subsystem from requesting a control point which is not defined 
in the system. The control point area is then built with all 
limit values set to unlimited or infinite. The control 
statement pointer (CSPW) is set to indicate an EOR on the input 
file. Default family information is set into PFCW and the 
family count incremented. The subsystem's queue priority and a 
CPU priority of MRPS-2 are set in JCIW. The procedure file 
sequence number is set in CSBW for use by 1SI. The exit mode 
7007 is set in the control point exchange package. The 
scheduler active bit is cleared from JSCL+1, the FNT interlock 
cleared, and the job name written into this PP's input register 
with an exit to PPR so that the PP program to initialize the 
subsystem will be loaded. Once the PP program is loaded into 
this PP, it initializes the control point field length, and so 
on, to fit the requirements of the subsystem, sets up a control 
statement stream or procedure file call (for TAF, NIP, RBF), and 
calls 1AJ to process the stream which brings the subsystem into 
execution. 
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clear T4, FA, 

and JP; 
set MP = -0 



read FNT 



/sFJZj*— | 





read FST 




o 



Figure 6-2. SFJ - Search For Job 
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no S~\ 
( SFJ2 J 




set origin 
rollable FL = 




n 



Figure 6-2. SFJ - Search For Job (Continued) 



60454300 A 



6-11 




set origin 
Tollable FL (FO) 




set rejection 
flag (T4) 




set priority (JP) 



set CM FL 
(JF) and 
ECS FL (JE) 



set previous 
MS activity (MP) 
and current 
MS activity (MS) 



set FST 
address (FA) 



save F NT for 
SFIM in SIFA 




Figure 6-2. SFJ - Search For Job (Continued) 
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include Tollable 
memory with 
available memory 



check TACP 









add rollable 
memory 




Figure 6-2. SFJ - Search For job (Continued) 
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disallow rollouts 



remove origin 
AM, FL, EC, and EM 
restrictions 




3SA/SSS 



schedule special 
subsystem 



Figure 6-2. SFJ - Search For Job (Continued) 
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PRIORITY EVALUATOR - 1SP 

Routine 1SP is called periodically by CPUMTR to perform the 
following functions. 

• Evaluate priorities of files in various queues. 

• Check central memory time slices for jobs at control 
points. If a time slice has expired, its priority is 
set to the lower bound for the job origin type and if 
the job is of t ime-shari ng ori gi n (TXOT) and output is 
available, it is rolled out. 

• Check for device checkpoint requests and call 1CK if any 
a re found. 

• Check for device initialization requests and call CMS if 
any are found. 

• All timed/event rollout jobs are made eligible for 
scheduling when the desired event has occurred or if 
their time has expired. 

• Check for accumulator overflow and call routine OAU to 
update the PROFILa file accordingly. 

A flowchart of the main routine of 1SP is shown in figure 6-3. 
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AJP 



adjust job 
priorities 



set priority 
aging control 



ATI 



advance time 
increments 



AFP 



adjust file 
priorities 




set 1SJ call 
into input register 




Figure 6-3. 1SP - Main Program 
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The following paragraphs describe several UP subroutines. 

ADJUST JOB PRIORITIES (AJP) 

AJP checks for wait response and swapout allowable indicators 
located in word SSCW of the control point area. If any wait 
response indicator is set without a corresponding swapout 
allowable indicator, the job receives a 2*CMSL times its 
specified CM slice to inhibit swapout. If wait response 
indicators are left set but the corresponding swapout allowable 
indicator is also set, the job will be considered a candidate 
for swapout. AJP also checks CM and CPU time slices and adjusts 
the job's priority if either of these has been exceeded. 

ADVANCE TIME INCREMENTS (ATI) 

ATI advances the increment interval associated with the IN 
service parameter for each queue type within the job origins. 

ADJUST FILE PRIORITIES (AFP) 

AFP ages queue files if priority aging is enabled. If the time 
increment was reset by ATI for the queue type for the origin 
type, the queue priority of the file being processed is advanced 
by one. In addition, if the time specified for a timed/event 
rollout file (TEFT) has expired, the file is converted to a 
rollout file (ROFT) and is given the upper bound rollout queue 
priority for its origin. When converting from TEFT to ROFT, the 
ECS field length is reset in FST byte 2 from the rollout file 
system sector. 

CHECK EVENT TABLE (CET) 

CET matches events from the systems event table with events 
specified in TEFT entries. AFP places those TEFTs waiting for 
events into a table for CET to read, thus requiring only one 
complete scan of the FNT to complete. If events match, the file 
is converted to a rollout file and given the upper bound rollout 
queue priority for its origin type. 

CHECK MASS STORAGE (CMS) 

CMS determines if a call to the mass storage subsystem is 
necessary. The following criteria are used. 

• When its delay (maintained in PFNL+1) has expired and 
removable packs are enabled 

• When CMS is required to diagnose mass storage error 
conditions 

• When initializations are pending on a mass storage device 

The activation of CMS is made by making a 1DS function 32 call 
to initiate the mass storage subsystem. 
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If it is necessary to call 1DS, the scheduler active bit (bit 59 
in JSCL+1) is cleared, the scheduler is requested via an RSJM 
function, and the 1DS request is written into this PP's input 
register and PPR is entered. 



CHECK IF CHECKPOINT NEEDED (CDV) 



CDV checks the 1CK recall time in JSCL+1 and calls 1CK if it is 
time to issue a checkpoint request and checkpoint requests were 
detected by CMS. The call to 1CK is entered into this PP's 
input register and PPR is entered after clearing the scheduler 
active bit and requesting the scheduler via an RSJM function. 



PROCESS OVERFLOW FLAGS (POF) 

POF detects accumulator overflow at a control point and if 
overflow exists ca I Is i ove rlay OAU to update the PROFILa file 
accordi ng ly . 



ADVANCE JOB STATUS - 1AJ 

Routine 1AJ advances the status of an active job. This action 
may be caused by one of the following occurrences. 

• The job scheduler C1SJ) wants to start a new job just 
scheduled to a control point 

• Monitor has sensed no activity at a control point 
(W and X bits clear) 

• DIS or other similar programs wish to process an error 
flag or a control statement 

The format of the 1AJ call is as follows. 



RA + 1 



59 



41 



35 



23 



1AJ C 


3 cp 


fn 


params 



cp Control point number 

fn Function number through 5 

params Parameters depending upon the function number 

For function number 0, TCS can be substituted for a 1AJ call 
For function numbers 4 and 5, the call must be made to TCS 
rather than 1 AJ . 
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The parameters for each function number are as follows. 



In 





Bits 

23-12 

11-0 



23-12 
11-0 

23-3 
2 

1 





23-0 
23-18 



17-0 



23-18 
17-0 



Peso ri pt ion 

Equal to 1 if set by 1AJ during DMP= 
processing in case of recall 
Equal to 1 if set by 1R0 upon completion of 
DMP = processing; set to 2 by DIS for SSJ= 
and DMP = processing 

Zero 

Address of input file from 1SJ 

Zero 

Set indicates control statement in MSlW 

(from DIS) 

Set indicates return error message to MS2W 

with no error flag on invalid control 

statement (from DIS) 

Set indicates read statement and stop prior 

to execute (RSS indicator) 

Zero (from other PP programs) 

Subfunction number for reading control 
s t atement . 

Advance poi nters 

1 Read only if not a local file load, 
do not advance pointers 

2 Set bit 17 in argument count if 
local file load; do not advance 
poi nters 

4x If parameters to be cracked in 
product set format 
Address to read/write control statement 
f rom/ to 

Zero 

Address from which to read control statement 

(for control statement read and execute) 



The programs called by 1AJ are as follows. 



P rogram 


1 CJ 


1RI 


1R0 


CIO 


DMP 


0AU 


0DF 



Description 

Complete job 

DMP* ro I li n 

Rollout job, normal rollout and DMP= rollout 

Complete special files on errors 

Exchange package dump (for certain error 

f lags) 

Update PROFIla f i le 
Drop f i le 
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The 



direct location assignments are: 

Desc ri pt ion 



common 


di rect Lo 


Name 


Va lue 


AB 


20-24 


CN 


25-31 


FS 


32-36 


EP 


37 


SP 


40-44 


OT 


45 


EF 


46 


RO 


47 


FA 


57 


CW 


60-64 


RF 


65 


SC 


67 



Assembly buffer 
CM word buffer 
FST entry 

Entry point pointer 
Statement pointer 
Job ori gin type 
Error flag 
Rollout flag 
Address of FST entry 
Library control word 
Reprieve error flag 
System control point 
activity 



(SCP) 



In general, 1AJ is called by MTR, 1SJ, or DIS. However, in the 
case of special entry point programs 1R0 will call 1AJ back after 
rolling a job out to DM* and setting up a control point for the 
special entry point routine. A special entry point job can be 
rolled out, and when it is rolled back in, 1RI calls 1AJ to 
advance it. 



Interaction between 1AJ, 1SJ, MTR, 1RI, and 1R0 
in figure 6-4. 

1 AJ uses the following overlays. 



is i I lust rated 



Over lay 

3AA 
3AB 
TCS 
LDR 
3AC 
3AD 
3AE 
3AF 
3AG 
3AH 



Description 

Begi n j ob 

Process error flag 

Translate control statement 

Load central program 

Search peripheral library 

Search for overlay 

Load copy routines 

Special entry point processor 

Termination processing 

Return special user files 



The PP memory layout is shown in figure 6-5. 

Figure 6-6 contains the flowchart of the main routine of 1AJ 

NOTE 

Control point area words used by 1AJ are described 
i n sect ion 2 . 
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If a special entry point is 
encountered-, then 1RI and 
1RO calls 1AJ. 



MTR calls 
1AJ to a control 
point with activity 




If an input file, 1SJ 
calls 1AJ-, if a rollout 
file, 1SJ calls 1RI. 



If rollout flag is 
set, 1AJ calls 1RO 



Rollout job 



Complete job 



If EOR on input file; that is, 
no more activity for this job 
or abnormal termination. 

Also if origin code greater 
than four. 



Figure 6-4, 1AJ Interaction 
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Job advancement 



UUVJU 

1100 


PP resident 




1AJ 

main 

program 


1436 


1AJ - Preset routines 

3AA - Begin job 

3AB - Process error flag 

3AG —Termination 
processing 


5347 - 


3AE - Load copy routines 
■ 3AF- Special entry 
point processor 

3AH - Return special 
files 




OOF- Drop files 


7777 





Translate control 
statement 



Absolute CP overlay 
loader 



4422 



TCS 

main 

program 



TCF - Preset routine 
3 AC - Search peripheral 
library 

3AE - Load copy routine 

3AF- Special entry 
point processor 



ODF-Drop files 





LDR 




main 




program 


2200 








3AD - Search for 




overlay 


6112 






3AE-Load copy 




routines 



Figure 6-5. 1AJ Major Overlay Memory Layout 



60454300 A 



6-22 




.1 






J 


f 




read control 




point status 




CM = STSW 




CN = JNMW 




AB = JCIW 




FS=RLPW 




T1 » EECW 




SP = CSPW 




CW = SSCW 






EF = error 
flag from 
CM+1 



RF = T1+1 
error flags 



t 




yes 



RF = 



no 




read SSOW 

(outstanding 

connections) 



are 

requests 

.outstanding 



yes 




no 




y^ is ^s. 

' EF=FSET ^ 
. (forced . 
^SsBrrorsJx^^ 




yes 


' 


' 








*1 


Sf>3 




SC=7 

















*1 Read one CM word into 5 PP words 

Figure 6-6. TAJ - Advance Job (Continued) 
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FS = X and 
W status 
from CM + FS 


>t 


OT = origin type 
from CN + 3 




*1 Is function number from IR+2 _> 4 (functions 4 and 5 are TCS 

f unct ions) 
*2 Protective code. If an origin code > 4 is not trapped, the 

processors will malfunction and the system could crash. 

Figure 6-6. 1AJ - Advance Job (Continued) 
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check for 
system control 
point activity 



set 1 CJ 
parameter to 




no 



set 1 CJ 
parameter to 1 



(A) = 1CJ 




*1 Only TXOT and MTOT have a processor (RTJX); no processor 
exists for the other origin types. 

Figure 6-6. 1AJ - Advance Job (Continued) 
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set bit 47 
in CSPW 



get queue 
priority 
ofCP1 



( RTJ J^ yes_ 




set EF to 

1R0 parameter 

inlR+4 




(A) = 1R0 




setPP 

call in to 

input register 

for this PPU 




*1 Ensure empty control statement buffer by indicating EOR. 
*2 Is queue priority of job at control point 1 equal to TXPS? 
*3 Only TXOT and MTOT have a processor (RTJ); no processor 
exists for the other origin types. 

Figure 6-6. 1AJ - Advance Job (Continued) 
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CM = SEPW 
CN = SPCW 





*1 Read 1 CM word into 5.PP words. 

*2 Is CN=CP entry point name * 0? 

• 3 Is RO + .F-S rollout flag + W. .+■ X status? 

* 4 Is RF or EF not = zero? 

*5 See description of overlay 3AF. 

*6 Function call with n=2. 



Figure 6-6. 1AJ - Advance Job (Continued) 
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*1 This path forces job to be rolled out and 1AJ to drop. 
*2 3AF exits via a call to 1R0 and drops from PP. 



Figure 6-6 



1AJ 



Advance Job (Continued) 
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set error to 
PPET; 
message = 

SECURE MEMORY, 
DUMP DISABLED 





set call name 



load 3AE 
copy routines 



I—p. 




set CP processor 



3AF/PSR 



process DMP 
processor 




DFM 



issue diagnostic 
message 



clear SPCW 
clear RA+1 
clear RO 
(rollout flag) 
set EF to 
SYET/PPET 




message = SPCW 
CALL ERROR 




*1 Bit 59 of DBAU set. 

*2 1AJ drops and this control point aborts. 

Figure 6-6. 1AJ - Advance Job (Continued) 
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3AB 



error 
processor 



I 



SCP 



check system 

control point 

activity 




*1 Exit to 1CJ if error flag set. 

*4 Bit 1 of IR+4 not set indicates no return of message 

Figure 6-6. 1AJ - Advance Job (Continued) 
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fOPp\ 




store 
message 
into MS2W 



setSPCW=0 



SCP 



check system 

control point 

activity 



TCS 



process 

control 

statement 



*1 




*1 Turn off any special processor commands. 

*2 Read next control statement and advance the job. If illegal 
control statements abort. 

Figure 6-6. 1AJ - Advance Job (Continued) 
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clear error flag 
(EF = 0) 





HOPP2 *4 



• 1 (SO bit 2 set. 

*2 Processors are defined as follows. 

SYOT AJSX 

BCOT AJSX 

EIOT AJSX 

TXOT RTJ 

MTOT RTJ 
*3 Is this the end of control statements; then terminate 
*4 Calls TCS 

Figure 6-6. 1AJ - Advance Job (Continued) 
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SCP 



check system 
control point 
activity 



jump to processor 



3AF/RCF 



restore 

control point 

fields 




•1 Only TXOT and MTOT have processor' CRTJ ) defined; no 
processor exist for other job origins. 

Figure 6-6. 1AJ - Advance Job (Continued) 
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JACM 



clear job 

advance flag 

FN = 2 




PPR 




Figure 6-6. 1AJ - Advance Job (Continued) 
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The following paragraphs describe 1AJ subroutines. 



BEGIN JOB (3AA) 

Routine 3AA initiates job processing at a control point. 
dayfiLe -messages issued by 3AA are the following. 



The 



JOB CARD ERROR. 

BINARY CARD xxxx SEQUENCE. 'ERROR . 

JOB IN NORERUN STATE ON RECOVERY. 

The direct location assignments are defined as follows. 



Name 



Va lue 



Description 



PP 
TN 
PA 
TT 
TA 



60 
61 
62 
64 
66 



Pot pointer 

Te rmi na I numbe r 

Pot address (2 words) 

Terminal table address (2 words) 

TELEX reference address 



The table of processors for 3AA is as follows 



Origin 


Processor 


SYOT 


BBC 


BCOT 


BBC 


EIOT 


BBC 


MTOT 


BMT 



A flowchart of 3AA is shown in figure 6-7 
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f BJB J 

get FST address 
of input file 
from IR + 4 



read input 
file FNT/FST 
entries 



save queue 
priority 



clear CP area 
TSCW + 1 
thru CSBW 



set infinite 
accounting and 
profile control 
values 



set input file 
FST address 
into TFSW 




store control 
statement pointer 
CSPW 



store 

control statement 

FST entry 



set time limit 
controls 



set keypunch 
mode in SNSW 




*1 Keypunch mode is passed to 1 AJ in the system sector of the 
i nput file 

Figure 6-7. 3AA - Begin Job 
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store job 
sequence number 
in RFCW 



set exit mode 
into exchange 
package 



clear FLX 
and RAX in 
exchange package 



preset RFL 
with values 
from job card 
FS + 1 and FS + 2 



CMX 



compute machine 
FL maximum 



set MFL - 
machine FL 
maximum (FS) 




set MFL to 
job card FL 
FS-^-FS+2 



*J 



preset RFL 
with values 
from job card 
CN+1 and CN+2 



ECS 



compute machine 
FLE maximum 



set MFL = 
machine FLE 
maximum (FS) 




set MFL to 
job card FLE 
CN^CN + 2 



I 



store FL control 
in FLCW and 
ELCW 



set default 
family equipment 
in PFCW 




Figure 6-7. 3AA - Begin Job (continued) 
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STBM 



set family 
activity count 



set validation 
words ALMW, 
ACLW and 
AACW unlimited 




set user 
identification 
in UIDW 




yes 


set up 

SYSTEMX/SYUI 
user identification 










r?) 






\D 



>1 



set validation 
required bit 
(bit 17) for 
user identification 



•1 Validation required bit from SSTL is set as bit of UIDW 
Figure 6-7. 3AA - Begin Job (Continued) 
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DFM 



issue accounting 
message for 
cards read 




clear RA, 
RA+1, RA + 2 




DFM 



issue job card 
to dayfile 



© 



*1 Job card not present if MTOT 



Figure 6-7. 3AA - Begin Job (Continued) 
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ACTM 



begin account block 
FM = ABBF 




no 



set accounting 
controls in STLW, 
SRJW and CPJW 



message = JOB 
CARD ERROR 






convert data 
for message 



DFM 



binary seq 
error 




yes 



message = JOB IN 
IMO RERUN STATE 
ON RECOVERY 




DFM 



issue message 




Figure 6-7. 3AA - Begin Job (Continued) 
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job cardsjand position INPUT to EQR 



/.. RJC \ 


\ job card / 


■ ' . -i 


r 


set track & sector 
inFST 


. 1 


' 


change job name 
to INPUT 


' 


r 


set exit 
mode = 7007 


i 


' 


( return J 



*1 The FNT/FST entry is described in section 2 
*2 For use in the exchange package 

Figure 6-7. 3AA - Begin Job (Continued) 
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set TELEX 

RA and SORT 

terminal 

number 



STA 



get input pot 

pointer 

word 



ECS 



enter 

control 

statement 



ETF 



enter 
terminal 
files+FNT 



RJSM 



get 

sequence 

number 



set time limit 

- 40, exit 
mode = 7007 



return 



*1 Read statement from TELEX pot and set up control statement 
Figure 6-7. 3AA - Begin Job (Continued) 
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PROCESS ERROR FLAG (3AB) 



Routine 3AB processes error flags by sending an error message to 
the dayfile. In the case of an arithmetic error, a call is made 
to DMP to dump the exchange package area. 

When these operations are complete, the control statement buffer 
is searched for the control statement EXIT. If this statement 
is found, 3AB returns to 1AJ to continue statement processing. 
If an EXIT is not found, control returns to 1AJ to complete the 
job processing. 



The dayfile messages are as follows. 
Message 
TIME LIMIT. 



Desc ri pt ion 



CPU ERROR EXIT xx AT 

yyyyyy- 

PP CALL ERROR. 

OPERATOR DROP. 
PROGRAM STOP AT xxxxxx 

SUBSYSTEM ABORTED. 



JOB STEP LIMIT. 
ACCOUNT BLOCK LIMIT. 
MONITOR CALL ERROR. 
SYSTEM ABORT. 
OPERATOR KILL. 



SECURE MEMORY, DUMP 
DISABLED. 



The monitor has detected that 
the time limit for the job has 
expired. 

The monitor has detected CPU 
error exit condition at xx 
address yyyyyy. 

The monitor has detected an 
error in a CPU request for PP 
act ion. 

The operator has dropped the job. 

The monitor detected a program 
stop instruction at address 
xxxxxx. 

A subsystem has aborted and all 
user jobs connected to this 
subsystem will have this message 
sent to their dayfiles and the 
SSET error flag set. 

The job step SRU limit has 
expi red . 

The SRU limit for the account 
b lock has expi red. 

An illegal RA+1 call has been 
i ssued . 

The job has been aborted with an 
SYET error type. 

The operator has killed the job. 
(Same as an operator drop except 
no error processing is done.) 

3AB attempts to produce an 
exchange package dump, but 
program has secure memory status. 
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SPECIAL REQUEST 
PROCESSING ERROR. 



3A8 attempts to produce an 
exchange package dump, but a 
program is a special call 
processor (SPCW set). 



REPRIEVE IMPOSSIBLE - 
BAD CHECKSUM. 



The checksum does not match 
checksum taken when reprieve 
cont rol set up . 



JOB REPRIEVED. 



Job is reprieved after an error 
A second message is issued to 
describe the conditions under 
which the job was reprieved. 



The table of processors for 3AB is as follows. 



Orig i n 



Processor 



SYOT 
BCOT 
EIOT 
TXOT 
MTOT 



EBC 
EBC 
EBC 
EBC 
EBC 



Overlay 3AB is flowcharted in figure 6-8 
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restore 
sense switches 



clear pause bit 
from SNSW 




MXFM 



hang system 



set EF = SYET 



Figure 6-8. 3AB - Process Error Flag 
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Figure 6-8. 3AB - Process Error Flag (Continued) 
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*1 Look for exit statement. 

*2 Refer to the EREXIT macro, section 6, volume 2, of the NOS 
R e f erenC e Manual for a description of error flags. 

Figure 6-8. 3AB - Process Error Flag (Continued) 
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read (RA) 



convert 

mode and 

address - 

display code 



DFM 



issue 

error 

message 





convert 
address 



DFM 



issue error 
message 



( DMP J 



*1 CPU ERROR EXIT (mode) AT <address). 
*2 PROGRAM STOP AT (address). 

Figure 6-8. 3AB - Process Error Flag (Continued) 
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read 
(RA+11 



replace zeros 
with spaces 




DFM 



issue 

(RA+1) 

dayfile 



return 




*1 Let user finish error processing if possible. 

Figure 6-8. 3AB - Process Error Flag (Continued) 
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no 



return via 
EBCX 



) 



DMP 
extra data 
from PPDW 



CPD 



empty statement 

buffer, set EOR 

iifCSPW 



clear PPDW 



(0MP1 J 




write logoff 

byte (0004) 

into message 

buffer (MS1W) 



return via 
EBCX 



3 



*1 Time sharing processings sends contents of message buffer to 
terminal. Since message buffer has Log off byte in it / 
terminal will be logged off. 

*2 Control point area PPDW contains the address of the control 
point area to dump and number of words to dump. 

Figure 6-8. Process Error Flag (Continued) 
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ACTM 



convert SRU 
accumulation 
function ABIF 




no, 



message - 

JOB STEP 

LIMIT 



message - 

ACCOUNT 

BLOCK 

LIMIT 




ITL 



request SRU 

increment 

function RLIS 




Figure 6-8. Process Error Flag (Continued) 
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TRANSLATE CONTROL STATEMENT (TCS) 

TCS translates control statements in the following manner. 

1. Reads statement from one of the following. 

• Control statement in the control point area 

• Message buffer for DIS type programs 

• Central memory location for an executing program 

2. Programs loaded from the system have their parameters 
processed with operating system separator equivalences, 
unless a *SC SYSEDIT directive was used when entering 
the program into the system. 

Local file program loads have their parameters processed 
with product set separator equivalences, as do all 
programs with *SC specifications, unless a slash (/) is 
prefixed to the program name. 

For NOS equivalences, delete all embedded spaces, up to 
the termination character (a period or right 
parenthesis). Any characters not in the standard 
FORTRAN set (for example, > £ ; ) are not allowed in the 
statement. They may be used in a comment. Arguments 
are processed such that the separator character is the 
lower six bits of the argument. 

For product set equivalences, separator characters are 
+-/=,($. Blanks are treated as separators. All 
special characters are treated as 4-bit codes in the 
lower six bits of the argument. 

3. Searches a list of special control statement names for 
a match with the statement being processed. These 
special names are CTIME, RTIME, and STIME. 



Ext r 
stat 
f i le 
poi n 
rest 
last 
f iel 
used 
f oun 
form 
If t 
abor 
is t 
exec 
call 
s tor 
a rea 
begi 



acts 
ement 

name 
twit 
ored 

RFL 
d len 

as t 
d on 
at, t 
he fi 
ted. 
ransf 
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ed i n 
, (RA 
n exe 
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if it 
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he i n 
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he lo 
le do 
If t 
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he pr 
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the 
+ 2 th 
cut io 



i rst se 
o a sep 
e f or a 
s name. 

is di f 
ment or 
s zero, 
i tial f 
s stor a 
a d e r is 
es not 
he file 

to the 
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c t ed f r 
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rough R 
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fere 

mac 

a s 
ield 
ge d 

ca I 
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The 
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or c 
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CYB 

arg 

he c 

gion 

T 
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hara 

sign 
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rom 

If 
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ER L 
umen 
ont r 
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char 
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If 
d i s 
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ss s 
at ab 
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ts f 
ol s 
the 
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and 
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runn 
d fi 
sue 
i n 
and 
t ora 
le f 
r to 
or t 
tate 
j ob 
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and 
un i cat i on 
ted to 
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5. Searches the central library (CLD) for a program with 
the name on the control statement. If such a program 
is found and contains an RFL= or MFL= special entry 
point, the field length is set accordingly. Otherwise 
the field length is set as described in step 4. The 
requested program is loaded and executed with arguments 
stored as described previously. 

6. If the statement name is a three-character name, the 
first of which is alphabetical searches the PP library 
(PLD) for a program of this name. If found, places 
this name with up to two octal arguments as a PP 
program request and exits to the program. No change 
is made in the job field length. This type of request 
is valid from system origin only or if the caller has 
system origin privileges and the system is in DEBUG 
mode. 

7. If none of the preceding steps are successful, the 
statement is declared illegal and the job is aborted. 

All control statements, with the exception of CTIME, RTIME, STIME 

some routine to be loaded or the 



and *comment 
job to abort 



statements, cause 



The following messages are issued by TCS. 



Message 
CONTROL STATEMENT LIMIT 

BUFFER ARG. ERROR. 
TCS ILLEGAL REQUEST. 
IMPROPER VALIDATION. 



FORMAT ERROR ON CONTROL 
CARD. 



SECURE MEMORY, DUMP 
DISABLED. 



TOO MANY ARGUMENTS. 



Description 

Control statements exceed 
control statement validation 
limit. 

CM address in call is not within 
the job's field length. 

TCS called with an illegal 
request; 

A validation program (with VAL=) 
i s requi red . 

An error has been detected in 
the format of the control 
statement. 

A DMP= processor is called 
following a job step that 
requires secure memory. 

The number of arguments on the 
control statement exceeds the 
amount allowed. 



FL TOO SHORT FOR 
PROGRAM. 



54 table MINFL is larger than FL 
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FL BEYOND MFL. 
ILLEGAL CONTROL CARD. 



Request FL exceeds MFL. 

The control statement could not 
be identified by TCS. 



A flowchart of TCS is illustrated in figure 6-9. 
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write statement 
to MS1W 




Figure 6-9. TCS - Main Routine 
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message = 

ILLEGAL 

CONTROL CARD 



IerriJ 



Figure 6-9. TCS - Main Routine (Continued) 
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SCL 

search 
central library 




search 
peripheral library 




TCS1QH- 



message = 
ILLEGAL 
CONTROL CARD 




ERR1 




search for 
special format 



IPL 



initialize 
program load 




Figure 6-9. TCS - Main Routine (Continued) 
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The following paragraphs describe the major portions of TCS. 



ISSUE STATEMENT TO DAYFILE (1ST) 

1ST issues the control statement and error messages, if any, to 
the dayfile, updates the control statement pointers in CSPW and 
advances the job. 1ST is flowcharted in figure 6-10. 



SEARCH FOR SPECIAL FORMAT (SSF) 

SSF processes the control statements CTIME, RTIME, and STIME and 
issues the CPU time (control point area word CPTW), real time 
(word RTCL) or SRU accumulation (word SRUW) to the dayfile. 
This is done in 1AJ rather than by a CPU program to eliminate 
any system overhead in these values. 

SEARCH FOR PROGRAM FILE (SPF) 

SPF determines if the program requested is local to the control 
point. SPF exits to subroutine SSF if the file is present. 

SEARCH CENTRAL LIBRARY (SCL) 

SCL searches the CLD and RCL in an attempt to find the desired 
program and causes it to be brought to the control point. SCL 
is flowcharted in figure 6-11. 



60454300 A 



6-58 





Figure 6-1 - 1ST - Issue Statement 
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Figure 6-10. 1ST - Issue Statement (Continued) 
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clear FST 
address 



(FA) 



LDR/CLD 



search 
CLD 



*1 



normal 
case 



continuation w/o 
ARG = 




clear 
SPCW 



return 



*1 Test modified for given cases 

Figure 6-11, SCL - Search Central Library 
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Figure 6-11. SCL - Search Central Library (Continued) 
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read FLCW 
clear one step 
RFL flag 



preset 

requested FL 
to value from 
CLD 






message = 
FL beyond 
MFL 



*1 Def i ni t ions 

MFL = byte of FLCW 
NFL = byte 1 of FLCW 
FL = current FL, byte 4 of STSW 

Figure 6-11- SCL - Search Central Library (Continued) 
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Figure 6-11. SCL - Search Central Library (Continued) 
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BEGIN CENTRAL PROGRAM (BCP) 

BCP obtains storage for the program, initializes the job 
communication area with the cracked arguments CRA+2 through 
RA+62B), the number of arguments (RA+ACTR), the control 
statement (RA+CCDR), the program name (RA+PGNR), the exchange 
package, and sets FLCW for this job step. The program is loaded 
into the field length and the job step begun with the RLMM 
monitor function. BCP is flowcharted in figure 6-12. 



ASSEMBLE KEYWORD (AKW) 

AKW extracts the program name from the control statement. 
Appropriate initializations are done for / (use NOS arguments), $ 
(load from system rather than local file), and * (comment) first 
characters. Job control language tags are ignored. 



ENTER ARGUMENTS (ARG) 

ARG processes the arguments on the control statement and sets 
them in RA+ARGR (RA+2) through RA+62B. The arguments are 
terminated by a word of binary zeros. Arguments are cracked in 
operating system format or product set format as directed by the 
characteristics of the load. If more than 60B arguments are 
present, the job is aborted with the diagnostic TOO MANY 
ARGUMENTS. No argument processing is done if the program has an 
ARG= ent ry poi nt , 
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set RSS 
and DIS bits 
for loading 




clear program 
name from 
RA + PGNR 




ASM 



assemble 
program name 



clear RSS flag 
from IR+4 



store program 
name in 
RA + PGNR 




Figure 6-12. BCP - Begin Central Program 



60454300 A 



6-66 



no 



no 




message = 
FL too short 
for program 



clear one step 
RFL flag 
in FLCW 



CLX 



clear exchange 
package 



-**|erri| 






3AF/TCA 

transfer control 
point area fields 




set argument count 
(RA + ACTR) store 
control statement 
(RA + CCDR) 



Figure 6-12. BCP ^ Begin Central Program (Continued) 
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set up for OAU 
call by read of 
JNMW, SRUW, 
FPFW 



store SEPW 



store CSPW 





OAU 



process overflow 



J 



ID — 


yes 


clear 1 RO 


Ir - 




called flag 


• no 















clear equipment 
from OAEW 





call 
3AH 






DEQM 



release 
equipment 



J 



Figure 6-12. BCP - Begin Central Program (Continued) 
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clear SSM status 



set SSM status 




Figure 6-12, BCP - Begin Central Program (Continued) 
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CHECK FOR SPECIAL ENTRY POINTS CCSE) 

CSE enforces the validation required condition (a VAL = entry 
point must be present if bit 17 is set in control point area 
word UIDW) and checks for DMP= control statements. If a DMP= 
control statement (a program with a DMP= entry point being 
called by a control statement) is encountered, the input 
register is written into control point area word SEPW, SPCW is 
set with the upper 18 bits of the input register, the DMP= and 
no RA+1 clear flags are set, and TERW has the lower 24 bits set 
with the lower 24 bits of the entry point word (DMP = control 
information). Routine 1AJ is recalled to process the SPCW 
request . 



CHECK VALID DMP= CALL (CVD) 

CVD enforces the secure memory protection required by the 
previous job step. If the current job step cannot follow the 
previous step because of secure memory, the diagnostic SECURE 
MEMORY, DUMP DISABLED is issued." 



PROCESS ERROR (ERR) 



ERR processes error conditions detected by TCS subroutines 
is flowcharted in figure 6-13. 



ERR 
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message = 

FORMAT ERROR 

on control statement 




ERR1 H- 



save message 
address 



CEFM 



set error flag 
to PPET 



3AF/RFJ 



reset 
former job 





set EOR 

and statement buffer 

empty in CSPW 



message = 

IMPROPER 

VALIDATION 



clear SDM 
status 



AKW 



assemble 
keyword 




clear end 
of program name 




^ 




write statement 
to MS1W area 




Figure 6-13. ERR - Error Processor 
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INTERROGATE ONE CHARACTER (IOC) 

IOC determines the status of a single character, indicating 
whether it is a valid separator according to the argument format 
(operating system or product set) being used. 



INITIALIZE PROGRAM LOAD (IPL) 

IPL initializes the control point area, loads the copy routines 
(3AE), and presets the requested field length. The event 
descriptor is cleared from TERW, pause bit cleared from SNSW, 
reprieve conditions cleared from EECW, terminal interrupt 
address cleared from TINW, and console message cleared from MS2W. 
The requested field length preset is the RFL or the nominal field 
length (FLCW byte 1) unless it is zero, in which case the 
minimum of the default field length (SYSDEF=50K) and MFL (FLCW 
byte ) i s used. The terminal interrupt bit is cleared for TXOT 
j obs . 



REQUEST STORAGE (RQS) 

RQS obtains the necessary field length for the program loading. 
If the field length is not available but pending, the input 
register is written in RLPW to recall the request. If not 
available and not pending, the control point is requested to be 
rolled out (ROCM) with the request recalled through RLPW. 



SEARCH LIBRARY TABLE (SLT) 

SLT searches a given library for a match on the request program 
name . 



SET SYSTEM CALL (SSC) 

SSC makes a library search (SCL) for routines LDR=, CALL, or 
SLDR=. If the desired routine is not found, an MXFM is done to 
hang the system and isolate the failure condition. If this hang 
occurs, it is not likely that any processing can occur. 



SKIP TO KEYWORD (STK) 

STK reformats the control statement, if ARG= has not been 
selected, excluding job control statement numbers and special 
first characters. 
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TRANSLATE SCOPE PARAMETER (TSS) 

TSS equivalences separators for the product set argument format. 
The equivalences used are as follows. 



Value 



Charac te r 



1 
2 
3 
4 
5 
6 
7 
10 



/ 
( 

+ 

b lank 



INITIALIZE DIRECT CELLS (INT) 

INT initialize the PP for processing of a control statement 
request. INT is flowcharted as figure 6-14. 

The following subroutines may be over Layed -by other 1AJ overlays 
called by TCS. 

ADVANCE TO EXIT STATEMENT (ATX) 

ATX checks for the exit flag set in-CSSW (bit 58) and if set 
clears it and searches for an EXIT control statement. If found, 
it is issued to the dayfile and processing continues by exiting 
to 1ST. 

CHECK STATEMENT LIMIT (CSL) 

CSL decrements the control statement count in control point area 
word ACLW using monitor function UADM. If the limit has been 
reached, CSPW is set empty and at EOR and the diagnostic CONTROL 
STATEMENT LIMIT is issued. CSL also causes a charge increment 
(IMCS) to be added to the mass storage accumulator in IOAW. 
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MNT J 



CN 


= STSW 


CM 


= JNMW 


AB 


= JCIW 


FS 


= UIDW 


SP 


= CSPW 


CW 


= SEPW 



queue ^s 
priority > 
LSSS^X 


,. yes 


set to bypass 
memory clear 


T no 







clear program 
format (PF), 
FST entry (FA), 
error flag (EF), 
entry point (EP) 




1CJ 



set IR + 2 = 



drop job 



set to drop PP 

instead of advance 

job on terminate 




V 








Figure 6-14. INT - Initialize Direct Cells 
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clear error 

exit control, 

reprieve options 

in EECW 



<T primary file ^ 


no 


f yes 




<^ null ^> 


yes 


1 no 




rewind pointers 

for primary file 

in TFSW 


I. 



MNT11J 




message = 

TCS ILLEGAL 

REQUEST 



(eRRiJ 



Figure 6-14. INT - Initialize Direct Cells (Continued) 
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read special 

call word 

SPCW 




bypass memory 
clear; reset 

input register 
from SEPW 



3AF/IDP 



initialize DMP : 
program load 




set to drop PP 
on termination 



C 



return 



J> 



Figure 6-14. INT - Initialize Direct Cells (Continued) 
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Figure 6-14. INT - Initialize Direct Cells (Continued) 
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READ CONTROL STATEMENT TO ADDRESS (RCA) 

RCA passes the next control statement to the requesting program 
at a specified address. Arguments are processed (ARG) and the 
program name set in RA+PGNR. If read with advance is specified, 
CSPW is updated to indicate that this control statement was 
processed and the statement is issued to the dayfile (unless SDM= 
i s present ) . 



READ NEXT CONTROL STATEMENT (RNC) 

RNC reads the next control statement whether from central memory, 
MS1W, or the control statement buffer, 

SEARCH PERIPHERAL LIBRARY - 3AC 

Overlay 3AC is called to search for the program name in the ♦ 
peripheral library. If the routine is found, the routine name 
and up to two 18-bit octal arguments are written to the PPI's 
input register and 3AC exits to 1ST. If the routine. is not 
found, 3AC returns to its caller. Routine 3AC is called only 
from the TCS main program. 



LOAD CENTRAL PROGRAM - LDR 

LDR loads absolute overlays in response to CPU program requests. 
LDR consists of 1AJ overlays LDR, 3AD, and 3AE. TCS uses these 
overlays, or parts of them, to get routines loaded. 

LDR is called with the parameters shown below. If the overlay 
is being loaded from the system, the central library (CLD) is 
searched for the overlay. The message OVERLAY NOT FOUND IN 
LIBRARY is issued if it is not found and the job step is aborted 
If the load is not from the system library, overlay 3AD is 
called to find the overlay or entry point. Once found, 
subroutine LCP (of the 3AE copy routines) is called to load the 
program. LDR sets the entry point address into the P register 
and drops the PP, thus causing execution to begin at that 
address. The setting of the P address and transfer of control 
is an option in the LDR request. 

The format of the LDR call is as follows. 



59 



RA + 1 



LDR 



40 



17 




addr 



r Autorecall if desired 
addr Address of request 



Refer to volume 2, section 11, of the NOS 
complete description of LDR requests. 



Reference Manual for a 
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SEARCH FOR OVERLAY - 3AD 

Routine 3AD performs an end around search of the overlay (local) 
file for an overlay of the requested name and level. If the 
file is not positioned at the beginning of a logical record, 
random data could possibly be interpreted as a valid overlay 
header. 

The following messages are issued by 3AD. 



Message 
OVERLAY FILE NOT FOUND 
I/O SEQUENCE ERROR. 
OVERLAY FILE EMPTY. 

OVERLAY NOT FOUND. 

FILE NOT ON MASS 
STORAGE. 

ENTRY POINT NOT FOUND. 
LOAD COPY ROUTINES - 3AE 



Desc ri pt ion 

Requested file is not available. 

Requested file is already busy. 

No data appears in requested 
file. 

Requested overlay is not on file 

The requested file does not 
reside on mass storage. 

Requested entry point is not on 
file. 



LOAD COPY ROUTINES - .SAE 

Routine 3AE contains subroutines that are used to load central 
programs into the control point's field length. The indi vidua I 
subroutines are described in the following paragraphs. 

LOAD CENTRAL PROGRAM C'LDC) 

If the load is from a local file, LDC exits to CMS (copy MS 
resident program). If the load is from the system, the library 
control word is interrogated to determine where the routine 
resides. If the routine resides on an alternate residency (ASR) 
device, control is transferred' to subroutine CCM. Control is 
returned if the ASR device is not ECS or DDP or if a SYSEDIT is 
active. When control is returned or ASR is not available, LCP 
requests a system device using monitor function (RSYM). If the 
program is in a format loadable by 3AE (OVL, ABS, or COS), 
control is given to CMS; otherwise, LCP returns to its caller 
with the address of a diagnostic message to issue. 



COPY MS RESIDENT PROGRAM (CMS) 

CMS reads the program from mass storage into the control point's 
field length. The job is charged for the load by incrementing 
the mass storage accumulator in IOAW by the number of sectors 
transferred and charge IMLL using the UADM monitor function. 
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SET LOAD PARAMETERS (SLP) 

SLP is called at the end of program loading by CMS and CCM to 
clear error mode and status bits from the exchange package, 
clear selected areas of the job communication area, and set up 
communication area words LWPR (last word address of program), 
FWPR (first word address of program), and LDRR (loader status). 
The status bits indicating CMU availability, CEJ/MEJ 
availability and character set mode are set in LWPR, FWPR and 
LDRR respectively. Parameters for the memory clearing done by 
TCS are also set by SLP. SLP exits to the caller of LCP. 

LOAD CM/AD (ECS) RESIDENT PROGRAMS (CCM) 

CCM loads system routines that reside in central memory (as 
directed by *CM SYSEDIT directives) or on ECS used as an 
alternate residency device (*AD SYSEDIT directives). The 
address to load the routine in the control point field length and 
the ECS position and CM address are passed as parameters on a 
LCEM monitor function. CPUMTR does the transferring of the 
program from ECS or CM to the control point. When the loading 
has completed, control is transferred to SLP. 

MASS STORAGE READ ERROR PROCESSOR (MSR) 

MSR is enteredif a mass storage error is encountered or if a 
bad ECS load address is encountered. An attempt is made to find 
an alternate source of the program so that it may be loaded 
correctly from that device. If none is found, the diagnostic 
OVERLAY LOST is issued and the job is aborted. If the overlay 
is being loaded from an alternate device, the attempt to 
determine a new source to load from will be made with the ASR 
check disabled If the local was from a local file the diagnostic 
UNRECOVERED MASS STORAGE ERROR is issued and the job is aborted. 



SET PROGRAM FORMAT (SPF) 

SPF returns the program format OVL, ABS, or COS and the MINFL 
from the 54 table (if any). 



CHECK PROGRAM FORMAT (CPF) 

CPF reads the program file to determine its format. CPF calls 
SPF. The diagnostic UNIDENTIFIED PROGRAM FORMAT is issued and the 
job aborted if the program format is not OVL, ABS, or COS. 

CHECK SYSEDIT ACTIVITY (CSA) 

CSA reads the RPL pointer (low core word RPLP) to determine if a 
SYSEDIT is active. If SYSEDIT is active, loading from CM or ASR 
i s proh ibi ted. 
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Dayfile message issued from 3AE include the following. 
Message Desc ri pt ion 



UNRECOVERED MASS 
STORAGE ERROR. 



An unrecoverable read error has 
occurred on a load from a local 
file. 



FL TOO SHORT FOR PROGRAM. Program length is larger than FL 



FLE TOO SHORT FOR LOAD. 

ILLEGAL LOAD ADDRESS. 

UNIDENTIFIED PROGRAM 
FORMAT. 

OVERLAY LOST. 



ECS block exceeds FLE. 

Load address is less than 2. 

The file requested to be loaded 
was not in a recognized format. 

No alternative path exists to 
load system routine after an 
unrecovered write error. 



SPECIAL ENTRY POINT PROCESSING - 3AF 

Routine 3AF contains subroutines for processing DMP= and SSJ= 

entry points. 

RESTORE CONTROL POINT FIELDS (RCF) 

RCF restores the UIDW, ALMW, ACLW, and AACW control point area 
words, sets the CPU and queue prior i t ies, and drops files with 
special system IDs (SSID) after. a job step which used an SSJ = 
entry point has completed or aborted. If the SSJ= did not have 
a block address, only the special ID files are dropped if that 
option was selected. The SEPW word is cleared in all calls to 
RCF. 

INITIALIZE DMP= LOAD ON RA+1 CALL (IDP) 

IDP moves the 20B-word parameter block, if any, from the calling 
program's field length to the control statement buffer for 
moving to the DMP= processor when it is loaded. If the calling 
program is also an SSJ- program, the SSJ block, if any, is moved 
to the control statement buffer for passing to the DMP= 
processor if it is an SSJ= processor. 

PROCESS SPECIAL PROCESSOR REQUEST (PSR) 

PSR formats the call to 1RQ to perform the dumping of the calling 
program's field length on a DMP= call. The dump active and 1RO 
called flags are set in SPCW, the DMP= parameter set in TERW, 
and the caller's field length set in PPDW. The DMP= function 
code (1) is set in IR+2, the DMP* parameter in IR+3 through IR+4, 
and 1R0 is loaded into this PPU. 
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RESET FORMER JOB (RFJ) 

RFJ formats the call to 1RI to reload the calling programs field 
length after a DMP = processor has completed or aborted. The SPPR 
parameter block is moved from the DMP = processor's communication 
area to the control statement buffer for restoring into the 
caller's field length when it is reloaded by 1 R I - The DMP = 
function code (1) is set in IR+2 and 1RI is loaded into this PP. 



START-UP DMP= JOB (SDP) 

SDP transfers the parameter block from the control statement 
buffer to RA+SPPR in the communication area. If SSJ= values are 
also being passed, they are moved from the control statement 
buffer to the SSJ= block in the D M P = processor's field length by 
subroutine TCA. The CPU is requested by an RCPM function and the 
PP is dropped, thus transferring control to the 0MP= processor. 



SET PRIORITIES (SPR) 

SPR sets CPU and queue priorities as well as the time limit 
associated with SSJ= processing. 



TRANSFER CONTROL POINT AREA FIELDS CTCA) 

TCA transfers control point area values to the SSJ= block in the 
program's field length, if an SSJ= block address has been 
specified. The CPU priority, queue priority and job step time 
limit, UIDW, ALMW, ACLW, and AACW are passed to the CPU program. 
The limit controls (ALMW, ACLW, and AACW) are then set to 
unlimited in the control point area and UIDW is set- for the 
system user number and index. If any time limit, CPU priority, 
or queue priority were specified in the SSJ= block, they are 
set for the control point by a call to SPR. 



TERMINATION PROCESSING - 3AG 

Routine 3AG is called to terminate processing when the program 
has connections to the system control point (SCP) facility. 



SEND RESPONSE TO SUBSYSTEM (SRS) 

SRS reads the subsystem control word CSSCW) to examine the wait 
response and long term connection indicators for each subsystem. 
If any indicators are set for a particular subsystem, a message 
is sent to that subsystem informing it of the user end/abort. 

If a subsystem aborts, all user jobs connected to the subsystem 
will have the error flag SSET (subsystem aborted) set. A system 
message is issued to the subsystems to which the user connected 
notifying them of the user abort. 
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CHECK SUBSYSTEM CONNECTION (CSC) 

CSC determines whether a job is in the queue (type ROFT or TEFT) 

with connections set (bit 5 of FNT set) , or a job is at a 

control point with connections set (SSCW word has appropriate 
connection indicators set). 



CALCULATE SUBSYSTEM INDEX POSITION (CSP) 

CSP uses the subsystem index to determine the position within 
the subsystem control word of the long term connection and wait 
response indicators (3 groups of indicators per byte). 



END USER JOBS (EUJ) 

EUJ ends all user jobs connected to a particular subsystem. The 
FNT is searched for all jobs with connections to this subsystem, 
as determined by CSC, and writes the subsystem index in the 
system sector and sets the job's priority to SSPS (subsystem 
aborted priority). 

Routine 3AG issues the following messages for display from MS2W 
of the subsystem control point. 



Message 

UCP ABORT. 
SUBSYSTEM BUSY. 

TERMINATION PROCESSING 



Desc ri pt ion 

User control point end/abort. 

Subsystem is unable to receive 

reply." 

Indicates subsystem end/abort 

process i ng . 



USER FILE PRIVACY PROCESSING - 3AH 

Routine 3AH returns all files associated with the job except 
those with user file privacy id set (UPID). 

COMPLETE JOB - 1 C J 



Routine 1CJ performs all the following job termination 

procedures. 



Release storage. 

Release assigned equipment. 

Release any common files used by the job. 

Drop any scratch files used by the job. 

Release all output files to output queue. 

Record in the account and control point dayf i les the 

accumulated system resource usage for the current account 

block. These resources consist of application units, 

permanent file usage, magnetic tape usage, mass storage 

usage, CPU time, and system resource units (SRU). 

Copy the cont rol poi nt dayf i le to the end of the print 

f i le. 

Update resource files. 

Clear the control point for usage by the next job. 
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The following accounting messages are issued to both the user's 
dayfile and the account dayfile. 



Message 

UEAD, XXXXX.XXXKUNS. 

UEPF, XXXXX.XXXKUNS. 

UEMT, XXXXX.XXXKUNS. 

UEMS, XXXXX.XXXKUNS. 

UECP, XXXXX.XXXSECS. 

UESR, XXXXX.XXXUNTS. 



Desc ri pt ion 

Application units (kilo-units) 
Permanent file usage (kilo-units) 
Magnetic tape usage (kilo-units) 
Mass storage usage (kilo- units) 
Accumulated CPU time (seconds) 
Accumulated SRUs (units) 



The following messages are issued only to the account dayfile. 



Message 
AEUN, usernum. 

AUSR., XXXXX.XXXUNTS. 



AUSR, 219902. 325UNTS 



Description 

Job terminated and input file 
requeued (RERUN) 

Accumulated SRUs (units) not 
updated into project profile 
file (PROFILA); this message 
indicates that 1 C J was 
unsuccessful in making its OAU 
call to update PROFILA. 

SRU overflow detected 



The following messages are issued to the system dayfile and 
user' s dayf i le : 



Message 

JOB RERUN. 

1CJ ARGUMENT ERROR. 



Description 

Named job is in RERUN 
Incorrect parameter in call 



The following message is issued only to the ERRL06 dayfile: 

Message Desc ri pt i on 

EQxx, OUTPUT LOST. Write errors occurred adding 

dayfile to output file or 
dumping output buffers 

The call to 1 CJ has the following format: 

59 40 35 23 



RA+1 



1CJ 



cp 



f 



cp Cont ro I poi nt 
f Function: 

Normal completion 

1 Rerun job 

Routine 1CJ is flowcharted in figure 6-15. 
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read job name 
JNMJ and job 
control JCIW 



read dayfile 
pointer in 
CMR DFPP 



RST 



release storage 



RLF 



release files 



*1 




*1 
*2 

• 3 



• 4 
*5 



RST issues RSTM 



Used at CPJ1 . 

Release all memory for this control point. 

request for zero words of memory. 

Close and clear all FNT/FST and drop all unused tracks for 

this control point (f i le OUTPUT wi 1 1 be checked later and if 

exists taken care of in RPF). Punch files are disposed to 

the output queue. 

Release all equipment assigned to this control point. 

Use ORF to clear the entry in RSXDid for this control point. 



Figure 6-15 1CJ - Complete Job 
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*1 Issue UEAD, UEMT, UEMS, UEPF, UECP, and AESR accounting 
messages . 

*2 Set print file name to job name, set type to PRFT, append 
dayfile to end of file, and release file from this control 
point. 



Figure 6-15 1CJ - Complete Job (Continued) 
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Figure 6-15 1CJ- Complete Job (Continued) 
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Figure 6-15 1 C J - Complete Job (Continued) 
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JOB ROLLOUT ROUTINE - 1RO 

Routine 1RO performs job rollout in response to a calling program 
(such as the job scheduler) or a dump field length function from 
1 AJ . 

The 1R0 call is as follows: 



IR 



59 



41 35 



23 17 



1 RO Cp 


fn 





n 



cp Control point number 
f n Rol lout 

1 Selective rollout to file DM* according to DMP= 
parameter 
n Error flag for TXOT job (function 0). For DMP= 

parameter (function 1) each bit defined as follows if 
set 

Bits Description 

17 Checkpoint 

16-15 Unused 

14 Create DM* file only 

13 Dump FNT entries to file DM* 

12 Create DM* as an unlocked file 

11-0 If 0, dump control point area and 

entire field length; if nonzero, dump 
control point area and FL*100B. 



Routine 1R0 uses the OBF, begin fi te, ; routine, 
location assignments are as follows: 



Its direct 



Name 



Value 



FS 


20-24 


NT 


25 


FW 


26 


SC 


27 


CN 


30-34 


TW 


35 


DP 


36 


0T 


37 


FN 


40-44 


TN 


45 


TT 


46-47 


FA 


57 


ZR 


60-64 


TA 


65 


OP 


66-67 



Description 

FST entry (5 locations) 

Next track pointer 

FNT word count or central memory 

index 

Sector count terminal output 

CM word buffer ( 5 locations) 

Constant 2 

Dayfile pointer address 

Origin type 

FNT entry (5 locations) 

Terminal number 

Terminal table address (2 

loca t ions) 

Address of FST entry 

CM zero word (5 locations) 

TELEX RA 

Output pointer (2 locations) 



Routine 1R0 is flowcharted in Figure 6-16 
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COMMON DECK COMSJRO 

Common deck COMSJRO defines the sector format of the rollout 
file. The symbols are used by the ro I lout / rol li n process. 

Symbo I Desc ri pt ion 

CPAI Control point area. The control point area is 

two sectors in length, and is the exact image of 
the control point area in central memory at the 
time of rol lout . 



DFBI 



FNTI 



Dayfile buffer. The dayfile buffer area is one 
sector in length, and is an exact image of the 
job dayfile buffer in central memory. 

File name table. The file name table area is n 
sectors in length, terminated by a short sector 
(logical record). The FNT entries are stored as 
two-word (FNT/FST) entries in this area. 



TOPI 



J FLI 



JECI 



Terminal output. The terminal output area is n 
sectors in length, terminated by a short sector 
(logical record). This is the only part of the 
rollout file that is unique for TXOT jobs. 

Job field length. The job field length area is n 
sectors in length, terminated by the EOI sector, 
and is an exact image of the job FL in central 
memory. If ECS is present, the FL is divided 
into two parts. The first part is the field 
length from RA to RA + (MCMX/2) - 1. The second 
part, which follows the ECS section, is the field 
length from RA + MCMX/2 to RA + FL - 1 . The 
value MCMX defines the minimum CM field length 
when ECS is present. 

Job ECS field length. The job ECS field length 
area is n sectors in length and is an exact image 
of the job ECS FL. 
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ROLLOUT FILE SYSTEM SECTOR 



Common deck COMSSSE ■ defi nes Locations within the system sector 
that are unique for rollout files. These locations, located in 
the file dependent data area (DOSS), are: 



Symbo I 



to BFMS (6776) 




52 


DBSS 


6 4 


INSS 


7 6 


AESS 


172 


SJSS 


173 





175 


FQSS 


176 


E R S S 


177 


SPSS 



230 



232 
2 33 
235 



241 
361 



SWSS 

CLSS 
SRSS 

TLSS 
TRSS 



Def i ni t i on 



Day file buffer pointers (two 

60-bit words) 

Input file FfiT and FST (two 

6 0<-bi t words) 

Assigned equipment list (1 byte 

per entry; terminated by a zero 

byte) 

SSJ= flag (nonzero if SSJ= job) 

Reserved (2 bytes) 

Family EST ordinal 

Rollout ECS FL/1000B 

SSJ= job parameter block (five 

60-bit. words) 

System control point data 

(SF.SWPI); upper 6 bits contain 

priority, lower 18 bits are 

completion address 

Job class 

Reserved (2 bytes) 

SRU information (60 bits); 

12 bits reserved, 6 bits flags, 

6 bits zero, 18 bits for time 

increment, and 18 bits for SRU 

i nc rement 

Terminal table at last rollout 

(20 60-bit words) 

Terminal table for recovery (20 

6 0^bi t words) 
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initial rollout operations 




CEQ 

clear 
equipment 



CFN 




clear FNT 
entries 



•*■ 



/3RP/RFG 



read first 

sector of 

terminal output 




associated with TXOT origin jobs if this is 



*1 Di sab Le al L jumps 

a no n- TXOT job. 
*2 Enter rollout file into FNT/FST. If DMP= call, then file 

name is DM* and control point will not be dropped. 
*3 Check for terminal input and output. 
*4 Request tracks for rollout file. 

*5 Release all equipment assigned to this control point. 
*6 Clear all FNT entries associated with this control point 

except the rollout file. 
*7 Prepares terminal output file for IAF/TELEX. 

Figure 6-16 IRO-Rollout Job 
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no 



read job name 
into FNSS 




set job class 
into CLSS 
clear SWSS 
clear SRSS 



set file 

type = ROFT 

(INFTif DMP=) 



no 




job class = 
job origin 





set special system 
job parameters 




Figure 6-16 1RO-Ro L lout Job (Continued) 
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reset FST 
address FA 



set sector 
word count 
BFMS-1 



CPA 



\ 



write control 
point area 



DFB 



write 
dayfile buffer 



7001 of PP 
memory PP 
MS buffer 



FNT 



write file 
name table 



3RP/WT0 



r© 



write 
terminal output 



JFL 



write job FL 



JEC 



\ 



write job FLE 



ra 



* 1 Disable aLL jumps associated with TXOT origin jobs if this is 
a non-TXOT job. 



Figure 6-16 1RO - Rollout Job (Continued) 



60454300 A 



6-94 





clear roll out 
flag in JCIW 



(pprJ 



^control pointN. 
^^ rolled ^S 


10 




Tyes 




clear K 
display data 




" ■ . 






" 




store FST/FNT 
entry values 
in FS & FN 




v 




set up IR, . . ., 
IR-4 for 1AJ 




1 


i 





Figure 6-16 1R0 - RoLLout Job (Continued) 
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JOB ROLLIN - 1RI 

Routine 1RI performs job rollin response to a catling program, 
such as the job scheduler. 

Its call is as follows: 



59 



IR 



41 



35 



23 



11 



1RI 





cp 


fn 





fa 



cp Control point number 
f n Ro I I i n job. 

1 Selective rollin according to special entry point 
fa FST address of rollin file 

The 1RI dayfile message ROLLIN FILE BAD signifies that an 
illegal format was detected in the rollin file (refer to Common 
Deck COMSJRO, in this section). 

Routine 1 R I has the following direct location assignments. 



Name 



Value 



FS 


20-24 


DP 


25 


EP 


25 


FI 


26 


CI 


27 


CN 


30-34 


PR 


35 


TW 


36 


OT 


37 


TN 


40 


TT 


41-42 


PP 


43 


PA 


44-45 


TA 


46 


TI 


47 


FA 


57 


ZR 


60-64 


EF 


65 


OU 


16-17 



Description 

FST entry (5 locations) 

Address of dayfile buffer pointer 

Ent ry point 

FNT buffer index 

Central memory index 

CM word buffer (5 locations) 

Queue priority 

Constant 2 

Origin type 

Te rmi na I Numbe r 

Terminal table address (2 locations) 

POT pointer 

POT address (2 locations) 

RA of TELEX 

TELEX FNT buffer index 

Address of FST entry 

CM zero word (5 locations) 

Er ror f lag ho Id 

Out pointer 



Routine 1RI (main routine) is flowcharted in figure 6-17 
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"pEs" 



preset routine 



SYS 



read 
system sector 



3RH/CRI 



clear rollin 
information 



CPA 



read control 
point area 



DFB 



read 
dayfile buffer 



FNT 



read 
FNT entries 



/3RH/TOP 



skip terminal 
output 



JFL 



read job FL 



JEC 



read job FLE 



EMS 



end mass 
storage 



EFN 



enter 
FNT entries 





*1 Disable all these if non-TXOT job. 

•2 Mass storage set and positioned in preset 

•3 Disabled if no FNTS. 



Figure 6-17 1RI - Rollin Job 
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*1 Disable if non-TXOT job. 

*2 Set up control point area, put job in W status (RCPM) 

request . 
*3 Drop FNT entry for this rollout file and drop all tracks 



Figure 6-17 1RI - Rollin Job 
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SYSTEM I/O (MASS STORAGE) 



AIL active files residing on rotating mass storage (RMS) are 
described by a file environment table (FET), a file name table 
(FNT), and a file status table (FST). The FET is supplied by 
the user and resides within the job field length. The FET is 
described in section 9- The FNT and FST are supplied by the 
system and are used by system routines to coordinate user 
requests for I/O and file positioning. Three other mass storage 
tables are involved with cont ro 1 1 i ng I/O . These are the 
equipment status table (EST), t he mass storage table (MST), and 
the track reservation table (TRT), 



TABLE LINKAGE 

The linkage between these tables is simple and reduces system 
overhead to a minimum. 



The 
The 
poi n 
i n a 
use r 
f i le 
requ 
unt i 
stat 
equi 
one- 
chan 
to t 
tab I 



FNT a 
FNT w 
t num 

user 
•s FE 

name 
est i n 
lam 
us, e 
pment 
word 
nels 
he MS 
es is 



nd FST 
ord (f 
ber wh 

FET w 
T with 

in th 
g Job 
atch i 
qui pme 

numbe 
ent r i e 
t hroug 
T for 

as f o 



a re 
i rs t 
i ch 
ith 

an 
e FE 
with 
s fo 
nt n 
r is 
s de 
h wh 
the 
I low 



two 

wor 
enab 
an F 
FNT/ 
T an 

the 
und . 
umbe 

use 
sc r i 
i ch 
devi 
s . 



one-word entries in a single CM table, 
d) contains the file name and a control 
les the system to associate an I/O request 
NT/FST word pair. The association of a 
FST word pair is obtained by comparing the 
d the control point number of the 

corresponding fields of each FNT entry 
The FST word (second word) contains file 
r, and track linkage and position. The 
d as an index into the EST which contains 
bing the mass storage device type, the 
the device maybe accessed, and a pointer 
ce. The inter-relationship of these 
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59 53 47 



35 



23 17 11 5 



FNT 



FST 



logical file name 


permis- 
sions 


file 
type 


t 


cp 
no. 


id 


lq 


first track 


current track 


current sector 


status 



cs 



47 



35 



23 



11 



EST 



flags 



channel 



select/ 
connect code 



device type 



address of 
MST/10B 



c 



MST 



TRT 



mass storage table 



track reservation table 



' MSTL=20 8 



Each MST is Located in CM on a 10B-word boundary so that the 
upper 12 significant bits of a 15-bit address can be stored in 
byte 4 of the EST as an MST pointer. The MST is a f i xed- lengt h 
table (2 OB words) which contains a complete description of the 
logical characteristics of a mass storage device. The MST is 
followed in memory by a va ri ab le- lengt h TRT which is used to 
maintain allocation of the mass storage device. 



TABLE CONTENT 

Space for the FNT, FST, EST, MSTs, and TRTs is allocated in CM 
at deadstart time. Pertinent information from the CMRDECK is 
transferred into the EST and MST at this time. As mass storage 
devices are recovered (activated) at deadstart time by RMS or 
on-line by CMS, pertinent information is extracted from the mass 
storage device label and placed in the MST and TRT. As files 
are created, changed, or released on a device, the MST and TRT 
are updated to reflect logical device status. An FNT/FST entry 
is created for a file when a user request is processed for a 
nonexistent file (for example, CIO open or I/O request). As 
operations are performed on the file, the FNT/FST entries are 
updated to reflect current status of the file. The FNT/FST 
entry is cleared when a file is returned. The detailed content 
of the FNT, FST, EST, MST, and TRT are described in section 2. 



t This bit is used to indicate special 
information in the system sector. 
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MASS STORAGE ALLOCATION 

The system allocates mass storage space to a file in increments 
of a unit called a track. Tracks are further divided into units 
called sectors or physical record units (PRUs). A sector is the 
smallest unit of mass storage space that can be read or written 
at a time. The number of tracks per mass storage device and the 
number of sectors per track are device-dependent and are shown 
i n table 7-1 . 

TABLE 7-1, TRT LENGTHS (OCTAL) 



Devi ce 



Mnemoni c 



Length 
in CM Words 



Track Count 



Logi ca I 
Sectors/Track 



| Sector 
I Buffer 

Si ze 

(Bytes) 



ECS 



844-21 

844-4x 
844-21 
844-4x 

885 

DDP/ECS 



DE 



DI 

DJ 
DK 
DL 



DM,DQ 
DP 



Dependent 
on ECS 
length 

630 

632 
630 
632 

645 

Dependent 
on ECS 
length 



Dependent 
on ECS 
length 

3140 

3150 
3140 
3 1 50 

3222 

Dependent 
on ECS 
length 



20 



153 

343 
160 
343 



6AQ (200 
20 



502 



502 

502 
502 
502 

502 

502 



Allocation of a mass storage device is controlled by a TRT. The 
TRT provides a track linkage byte and three flag bits for each 
track of a mass storage device. The track linkage bytes are 
used by the system to form a linked list of tracks as they are 
assigned to a file. The upper bit of each track linkage byte is 
a track linkage flag which indicates whether the remainder of 
the linkage byte represents a link to the next track for a file 
or whether it indicates a sector number within the track that is 
the last sector of the file. The last sector for a file is known 
as the end-of-information (E0I). The three flag bits for a track 
indicate whether it is free or allocated, whether it is 
interlocked or not, and whether it is the first track of a 
preserved file or not. 

The TRT for a device contains the number of words as described 
in table 7-1 with each word containing linkage and control 



information pertaining to four tracks. Bytes 0, 1, 2, and 3 of 
each word of the TRT contain the track linkage byte pertaining t 
four tracks. Byte 4 contains the three flag bits for each of th 



four tracks represented by bytes through 3 
shows the format of each TRT word. 



The following 
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59 


47 


35 


23 


11 


7 


3 


byte 


byte 1 


byte 2 


byte 3 


d 


w 


i 



byte n Track Link byte 

d A bit is set corresponding to bytes 

through 3 to identify the first track of 
a preserved file chain 

w A bit set establishes an interlock for a 

track 

i A bit set indicates track reservation 

When set, the upper bit of each track linkage byte indicates 
linkage to the next track in a chain; when clear, it indicates 
which sector of the track is the EOI. For 

each of the three 4-bit flag fields contained in byte 4 (d, w, 
and i), the bits from left to right correspond to the same 
tracks represented by bytes through 3, respectively. The 
track link byte format is as follows. 



track link 



EOI sector 



The following illustrates the correspondence between the control 
bit and the track linkage byte. 









3 


2 


1 









-\ 


i 




I 




f 








\ 






1 




_j 








\ 






' ' , < 


' 




\ 




i 


1 


i 


\ 


1 


byte 


byte 1 


byte 2 


byte 3 


d 


w 


i 



The d and w fields map in the same manner as the i field. 
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FILE LINKAGE 

The first and current track fields in the FST and the track Link 
bytes of the TRT contain a number that; can be broken down to 
determine the word within the TRT and the byte wi thi n that word 
that is used to '-represent the track number. The general link 
byte format is as follows-. 



11 



10 



z x y 



1 for next link in chain in bits 10 

and for EOI sector number in bits 

0. (Always 1 for first and current 
FST.) 



through 0, 
10 through 
t rack of 



TRT word relative to word of this TRT 
Byte within word x. 
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The following is an example showing file linkage from FST to EST 
to MST. Notice that the file occupies, space on tracks 5, 12, 14, 
15, 16, 17 and 20. The EOI is sector 7 of track 20. The EST 
entry shows that the device is an 844-21 (device type byte 
equals' 041 1B, display code for DI) so that the MST/TRT length is 
650 octal words. Also, the FST entry shows that the file is 
currently positioned at EOI. TRT linkage can also go backward 
(for example, 4012 points to 4002 which points to 4007). Tracks 
are linked and delinked by CPUM.TR in response to PP requests. 




TRT=MST+MSTL 



t FST status (refer to Section 2) 
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DISK SECTOR 

Every sector, from a user standpoint, contains up to 64 (1Q0B) 
CM words. However, the system always prefixes the sector with 
two header bytes (24 bits). These two header bytes contain file 
Linkage and other information. The general format of a disk 
sector is as follows. 



header 
byte 1 



header 
byte 2 



from 0-100B CM 
words of data 



There are five types of sectors known to the system and labeled 
via the header bytes. These are: 

End-of-record (EOR) sector 

End-of-file (EOF) sector 

End-of-inf ormation (EOI) sector 

System sector 

Full sector 

Header byte 2 contains a word count of the number of CM words 
within the sector as written by the user. The word count (VIC.) 
is in the range to 100B. If the word count equals 100B, the 
sector is full. If the word count is less than 100B, the sector 
is called a short PRU and indicates an EOR. Table 7-2 shows the 
relationship between the sector types and the contents of the 
heade r bytes . 



60454300 A 



7-7 



TABLE 7-2. SECTOR HEADER BYTE CONTENTS 



Sector 
Type 



Header Byte 1 



Header Byte 2 



Comment 



EOR 

EOF 
EOI 
System 

FuLL 



Next Sector/Track 





3777B 

Next Sector/Tr ac k 



< WC < 1Q0B 

Next Sector /Track 

77B 

WC=100B 



May 

cont ai n 
data 

No data 

No data 

System 
data only 



Full 
sector 



In table 7-2, a full sector differs from an EOR sector by WC=1Q0B 
rather than WC<100B as for the EOR sector. 

To differentiate between a Link to another track rather than to 
the next sector in header byte 1, the upper bit (bit 11) is set. 

The PP common decks that read/write mass storage perform the 
reading and writing of the header bytes. ALso, CIO reads/writes 
the header bytes' for disk I/O. 

In table 7-2, the system sector for a file is indicated by 
special header byte values. This is done to prevent accidental 
reading through the system sector itself. The system sector is 
always sector of the first track of a file. 

Examples of the various sector types are shown in figure 7-1. 
The device is assumed to be an 844-21; therefore, the sector 
count is from to 152B. Two situations not shown in figure 7->1 
are an EOR and an EOF as the last sector on a track which link 
to the next track. 
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Sector 
number 



152 



First logical track 



3777 



0077 



System 
Sector 



0002 



0100 



all data 



0003 



0042 



EOR 



0004 



0100 



all data 



4005 



0100 



all data 



— i 



j 



Second logical track (5) 





0001 


«6 

<6 ' 

■ 
«= 




1 

2 
3 


0022 


EOR 




0002 


0100 


all data 




0000 


0003 


EOF 




0000 


0000 




EOI 





152 



Sectors 4-152 
are not used 




Figure 7-1. RMS File Structure 



60454300 A 



7-9 



SYSTEM SECTOR 

The system sector is the first sector of a mass storage file and 
contains system information. PP routines (for example, CIO, 1TA, 
1R0) that write mass storage files begin by writing a system 
sector. The system sector is generally written by PP common 
deck COMPWSS. Although the calling routine stores various 
system information in the system sector, COMPWSS stores the 
control (header) bytes, the FNT/FST, and the data according to 
the following format. System information varies with 
different routines. For example, a rollout file system sector 
(Figure 7-2) includes dayfile buffer pointers, a copy of the 
input file FNT/FST, any operator assigned equipment, and terminal 
table information for time-sharing jobs. 









3777 


0077 


FNT entry 


w 


WA 


2 


eq 


ft 


OOOO 


0000 


fa 




packed date from PDTL 


in CMR 






■% 















system information 



eq EST ordinal of this equipment 

ft first track of this file 

fa address of FST entry 

Figure 7-2. Rollout File System Sector 



DISK I/O FROM PPs 

Disk I/O from PPs involves the folio wing basic functions 

1. Initialize I/O operation. 

2. Perform I/O and error processing. 

3. End mass storage operation. 
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The following code illustrates these functions. 



1 . STD T5 

SETMS READ 



SET EQUIPMENT 
INITIALIZE DRIVER 



STD 
STD 
LDC 
RJM 
MJN 

ENDMS 



T6 

T7 

BUF 

RDS 

ERR 



SET TRACK AND SECTOR 

READ SECTOR 

I F E R R R 

END MASS STOAGE OPERATION 



INITIALIZE I/O OPERATION VI A S ETMS M AC RO 

The first step of any I/O operation is to initialize the driver 
This function is performed by first setting the equipment and 
then executing the SETMS macro. The SETMS macro performs the 
following functions. 

1. Insures correct driver is loaded. 

2 . Passes the operation to the driver. Possible 

operations are read, w ri te, and read of system file. 

3. Executes driver preset and clears driver cells DRSW, 
RDCT, STSA, ERXA, and WDSE. 

4. Selects error processing options and writes error 
processing buffer. 

The format of the SETMS macro is as follows. 



LOCATION 



OPERATION 



SETMS 



VARIABLE SUBFIELDS 



op, (epl,ep2, . . . , epn) ,wb 
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op I/O Operation Being Performed: 

op_ Meani ng 

READ RDS will be called 
WRITE WDS will be called 
READSYS Read of system file 



NOTE 

T5 must be set to any system device 
equipment upon entry to SETMS. This 
is so the correct driver can be 
loaded for that equipment type. The 
actual system equipment used will be 
set at the time the driver requests 
the channe I . 



epn 



wb 



Error processing options. 

Error processing is selected by default if this 
field is not set. If this field is used COMSMSP 
must be present because it contains the bit 
definitions for the error options. 

epi Meani ng 



NE No processing of errors by caller. If an 
unrecovered error occurs the job will be 
aborted and the PP will be dropped. 

SM Suppress error log messages. No error log 

messages will be issued for errors occurring 
while this option is selected. 

RR Return on reserve errors. If a CR (controller 
reserve) or an RS (drive reserve) error is 
encountered, control will return to the calling 
program without any retries. 

NR Return on not ready. If a NR (not ready) error 
is encountered, control will return to the 
calling program without any retries. 

AR Return on all errors. Whenever any error 

occurs control is returned to the caller without 
any ret r i es . 

Address of a 502B byte buffer than can be used 
during write error processing to retry errors 
encountered on the previous sector. 
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I/O OPERATION AND ERROR PROCESSING 

The second functional area of an I/O operation is the I/O itself 
I/O is done by the driver routines RDS (read sector) and WDS 
(write sector). The entry/exit conditions for these routines 
a re as f o I lows . 

Ent ry to RDS : 

(T4)= Channel if driver previously called, T4 is 
set by the driver upon initial entry when it 
reserves a channel. 

(T5)= Equipment. 

(T6)= Track. 

(T7)= Sec to r. 

(A) = Address of 5 02B byte buffer of data to be 
written to disk. 



Exit: (A) = <0 if error and error processing is not 
deselected .. 

Entry to WDS: 

(T4)~ Channel if driver previously called. T4 is 
set by the driver upon initial entry when it 
reserves a channel. 

(T5)= Equipment. 

(T6)= Track. 

(T7)= Sector. 

(A) = Buffer address .+ consecutive sector indicator 
WCSF is added to the buffer address if a 
consecutive sector will follow the present 
sector. 

WLSF is added to the, buffer address if this is 
the last of a consecutive string of sectors 
being wri t ten . 

See Example 1 for an illustration of the use 
of WCSF and WLSF. 



Exi t 
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(A) = -0 if unrecovered error. 

(A) = -1 if a recovered error has occurred on the 
previous sector. The -1 indicates that the 
data buffer for the current sector has been 
destroyed and that the current sector must be 
rei ssued . 

See Example 2 for the use of the reissue sector. 
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Examp le 1: 

Write consecut i ve/ Last sector flag usage 



STD T5 

SETMS WRITE, ,EBUF 



WRITE A FILE OF E0I, BUF IS CLEARED WITH ZEROS 



STD 


T6 


LDN 





STD 


T7 


LDC 


BUF+WCSF 


RJM 


WDS 


MJN 


ERR 


AOD 


T7 


LMM 


SLM 


NJN 


B 


STD 


T7 


LDI 


NT 


STD 


T6 


AOD 


NT 


SOD 


SC 


NJN 


A 


LDC 


BUF+WLSF 


RJM 


WDS 


MJN 


ERR 


ENDMS 





SF CONSECUTIVE SECTOR FOLLOWS THIS SECTOR 
IF ERROR 



IF NOT END OF TRACK 
RESET SECTOR 
SET NEXT TRACK 



IF NOT LAST SECTOR 
WRITE LAST SECTOR 

IF ERROR 

END MASS STORAGE OPERATION 

NOTE 



It is not necessary to tell the driver when 
writing the last sector of a track. 



Examp le 2 : 

Reissue of current sector. Whenever the following conditions 

are met the PP program should be set up to reissue the current 
sector. 



• More than one sector is being written consecutively. 
That is, WCSF being used. 

• A write error processing buffer is not defined. 

• Error processing is not deselected. 
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STD 
SETMS 



T5 
WRITE 



NO ERROR PROCESSING BUFFER BUT CALLER 
WISHES TO PROCESS ERRORS. 



STD 


T6 


STD 

• 


T.7 


LDC 


BUF1+WCSF 


RJM 


WDS 


MJN 


ERR 


AOD 


T7 


LDC 


BUF2+WCSF 


RJM 


WDS 


PJN 


B 


ADN 


1 


ZJN 


A 


UJN 


ERR 



AOD 



T7 



LDC 


BUF3+WLSF 


RJM 


WDS 


PJN 


D 


ADN 


1 


ZJN 


C 


UJN 


ERR 



ENDMS 



WRITE SECTOR 1 

IF ERROR - REISSUE NOT POSSIBLE ON FIRST 

WRITE SECTOR 2 

IF NO ERROR 

IF REISSUE OF SECTOR 2 
PROCESS ERROR 

WRITE SECTOR 3 (LAST SECTOR) 

IF NO ERROR 

IF REISSUE OF SECTOR 3 
PROCESS ERROR 

END MASS STORAGE OPERATION 



END MASS STORAGE OPERATION 

ENDMS releases all resources assigned because of an I/O 
operation. For the 6DI driver this means the drive and 
controller are released via the operation complete function after 
which the channel and software unit interlock is released. 

For the 6DE driver it means the PP buffer interlock is released 
since no channel is applicable to this driver. 

ENDMS has the following entry conditions. 

Entry: (T4) = Channel as set by the driver. If no driver 

call was executed since the initial SETMS, then 
T4 i s ignored . 

(T5) = Equipment. 

Exit: None . 
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GENERAL PROGRAMMING CONSIDERATIONS 

Storage Move 

Any time the driver is entered (via R D S , W D S , ENDMS) the control 
point may be storage moved. Care must be taken if the value of 
RA is stored in any instructions. 

Random I/O 

Whenever the track ( T 6 ) is changed and the I/O operation is not 
starting at the beginning of the track (sector 0) a SETMS macro 
must be executed to have the driver note the random operation 
and reposition. The ENDMS will also force a reposition but 
should only be used if it is desirable to release the I/O 
resources. 

Switching Equipments 

It is imperative that an ENDMS is done for the equipment 
switching from and a SETMS is done for the equipment being 
swi tched to. 

SETMS, ENDMS Sequences Allowed 

Given that a SETMS begins an I/O sequence on a device and the 
ENDMS ends the sequence, virtually any combination of SETMS, 
ENDMS, and I/O can be done in between. This is contingent upon 
following the proper rules for random I/O and specifying the 
operation via SETMS. 

The following flow chart should illustrate the more common 
sequences, all of which are legal. 



1 . SETMS 

2. No I/O 

3. ENDMS 



SETMS 

I/O 

SETMS 

I/O 

ENDMS 



SETMS 

I/O 

ENDMS 

I/O 

ENDMS 



DUAL, SHARED, AND MULTIPLE ACCESS 

Dual access means that a disk storage unit (drive) has an access 
to it from two controllers on different channels from the same 
mainframe. Shared access means that a disk storage unit has an 
access to it from a controller that can be accessed by more than 
one mainframe. If a drive has both dual and shared access to it, 
it is called multiple access. This latter configuration is the 
one most commonly found in mu 1 1 ima i nf rame environments. These 
configurations are displayed in figure 7-3. 
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DUAL ACCESS 
•Dual-access drives 

• One drive access to 
each controller 

©■Each controller 
connected to same 
mainframe and has 
its own channel 




SHARED ACCESS 

• One controller 
access to drives 

•Controller access by 
two mainframes 



t Controllers 
1 1 Dri ves 



Figure 7-3. Dual-, Shared-, and Multiple-Access Configurations 
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mainframe 1 



mainframe 2 






tt 



MULTIPLE ACCESS 

•Dual-access drives 

• One drive access to 
each controller 

•Controller access 
by two mainframes 



t Cont rot Le rs 
ft Dri ves 



Figure 7-3. 



Dual-, Shared-, and Mu It ip Le-Acces s 
Configurations (Continued) 
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SEEK OVERLAP - 6DI DRIVER 

The 6DI driver performs a seek operation to inform the disk 
controller of an address to position to in preparation for the 
next data transfer. Once the seek is initiated by the 
controller, the disk drive can complete the positioning without 
further direction from the controller. This allows the 
controller to perform read and write operations or to initiate 
positioning on other drives that may be accessed through the 
controller. This overlapping of head positioning with reading, 
writing, or initiation of head movement is called seek overlap. 

The overlapping of seek operations is managed by the driver seek 
wait monitor function CDSWM). 



MMF OPERATION OF SEEK OVERLAP 

There are two basic differences in driver operation between MMF 
and non-MMF configurations. 



Firs 
rese 
sys t 
i nt e 
s i mi 
via 
A ti 
rese 
seco 
er ro 
unre 



t, in an MMF environment it is possible to get a drive 
rved status back from the seek operation. In non-MMF 
ems this status should never be seen because of the software 
rlock on the unit. The drive reserved status is handled 
larly to the non-MMF drive busy. The controller is released 
the operation complete and the channel is released via DSWM. 
me-out scheme is employed for both drive and controller 
rve conditions and any time the condition persists for 5 
nds an error indication is returned to the driver. The 
r must persist through 64 retries before being considered 
cove rab le . 



The second difference is that in an MMF environment the drive 
cannot be released during the seek operation. If it was, the 
other machine could reseek to a different position and thrashing 
would result. Thus, in an MMF environment the I/O operation must 
be done on the same channel as the seek. 



NON-MMF OPERATION OF SEEK OVERLAP 

After the seek function is issued the only status that should be 
received is either drive busy or an error status. If drive busy 
is received, the drive and controller are released via the 
operation complete function. This releasing of the drive allows 
the driver to come back and do I/O to that unit from the other 
channel on a dual channel configuration. The channel is then 
released to the system via the DSWM monitor function. The drive 
is protected from other requests for the unit by the software 
unit reserve in MST word DILL. This interlock is gained at the 
time a channel is initially assigned and is not released until 
an ENDMS is encountered. 
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The channel is now free for other I/O requests. Every time 
through the HTR loop a check is made for a free channel to 
assign to the seeking driver. If one is free it is assigned and 
the driver will reseek and check again for on-cylinder status. 
This sequence continues until an error or on-cylinder is 
detect ed . 



FLOWCHARTS FROM 6DI DRIVER 

A core map is found in figure 7-4. Flowcharts from the 6DI 
driver are shown in figures 7-5 through 7-11. PRS (preset) is 
entered from SMS while the other three routines are entered via 
return jumps to EMD, RDS, and WDS. 
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ALL disk drivers are originated at Location MSFW for Loading 
into PP resident. The first Location (556) contains the 
entry point to the preset subroutine within the driver. This is 
used by SMS when it has been determined that the correct driver 
is Loaded. FoLLowing this are the three entry points: 

557 RDS - Read sector 

562 WDS - Write sector 

565 EMS - End mass storage operation 

The symboLs WDS and RDS are defined in PPCOM and are the 
same for aLL drivers. The foLLowing functions from the 
6DI mass storage driver are fLowcharted. 

• PRS - Preset 

FNC - Issue function 

EMS - End mass storage operation 

RDS - Read sector 

WDS - Write sector 

LDA - Load address . 

DSW - Driver seek wait processing 

DST - Check drive status 
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MSFW 



RDS 



WDS 



EMS 



PRS 



PPFW 



BFMS 



EPFW 



SMS 


Driver preset address 


RDS SUBR 




Read sector 


UJN 


RDS. 




WDS SUBR 




Write sector 


UJN 


WDS. 




EMS SUBR 




End mass 
storage 


RDS. 






WDS. 






Preset for driver 


Buffer 


Error processor 



Figure 7-4. MS Driver Core Map 
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select seek 

function for 

1:1 or 2:1 

interlace 



preset MMF 

non-MMF 

operation 




Figure 7-5. PRS - Preset 



60454300 B 



7-23 



5L 

wait output 
register clear 



convert address 

to physical address 

LDAM 



set reposition 
flag 



yes 



issue 
seek function 



output physical 
address 





controller "^ no 
connected 



take status 




set controller 
connected 



Figure 7-6. LDA - Load Address 
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DSW 




..channel statusvno 
\ = requested S*~~" 
channel status 

( return ] 




DSWM 
monitor 
function 



read T4, T5 

as set by 

DSWM 



v 



set channel 
instructions 



Jl 



set channel 

status as 

set by DSWM 



issue 
operation 
complete 



wait for 
accept 



ik. 



Figure 7-7. DSW - Driver Seek Wait 
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set 
position 
required 


v 


call OSW 

with return 

channel status 


v 


( 


exit 


) 



Figure 7-8. EMS - End Mass Storage 



60454300 B 



7-26 




issue 

read 

function 



input 
data 



set exit 
to RDSX 




LDA 



load 
address 



Figure 7-9- RDS - Read Sector 
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save buffer 
address 



save write 
last sector 
flag 



set normal 
write function 



Jfc 




issue write 
function 



output 
data 




set write 

last sector 

function 



Figure 7-10. WDS - Write Sector 
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(A) = function number 



function 
equipment 



FAN CH 



yes 



i0 




yes 



set buffer 
word count 



(A) = 502 



activate channel 



return 



Figure 7-11. FNC - Issue Function 
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DST 



incomplete 
transfer 



yes 



no 



yS OUtpUt v*. 

X. operation y? 


yes 


wait for 




channel empty 




no 










v 






disconnect 






channel 










\ 


f 




take 




general 




status 












Figure 7-12. DST - Check Drive Status 
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6DP DPP/ECS DRIVER 

Routine 6DP provides the capability to access the ECS I and ECS 
II secondary storage devices via the DC135 or the parity 
enhanced DC145 DDP. Routine 6DP performs the basic read/write 
functions for the DP type equipments. 

Whenever an unrecove rab Le ECS abort occurs, 7DP, the DDP/ECS 
error processor, is called. If a read function was being 
processed and a parity error occurred, 7DP calls 7RP. Routine 
7RP retrieves the data in error from the DDP port and completes 
the read of the remaining ECS words (7RP is not called on a write 
parity error). After 7RP is called on a read parity error, 7RP 
recalls 7DP. At this time 7DP issues its first DEPM and calls 
7EP, causing the initial error message to be issued for the 
block of data being read or written. 

Once control is returned to 7DP, it calls 7SP to reread or 
rewrite the data one word at a time and compares previously read 
data with the new data. Routine 7SP calls 7MP to issue 
intermediate ECS error message whenever the data read does not 
compare. After issuing the error message, 7MP recalls 7SP to 
continue the single word read or write error recovery process. 
Once 7SP completes its single word reads or writes, it recalls 
7DP. Routine 7DP issues another DEPM and calls 7EP which issues 
a finat error message for the read or write function, showing an 
unrecovered or recovered status for the entire operation. 

Figure 7-13 illustrates the preceding process. 
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Figure 7-13. 6DP DOP/ECS Driver 
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NOTE 

If a function timeout occurs 
or address not accepted, 7SP 
will set its abort flag before 
calling 7DP. 
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MASS STORAGE INITIALIZATION AND RECOVERY 



The initialization and recovery of mass storage devices is 
controlled by three routines: recover mass storage (RMS), check 
mass storage (CMS), and system recovery processor (REC) . All 
mass storage devices have a label which contains information 
identifying the equipment and usages of it such as pack name, 
device number, and device masks. The usages of a mass storage 
device are defined through an initialization and these 
attributes remain with the device until the device attributes 
are redefined by subsequent initializations. 



This section deals with the recovery and i ni t i a I i za t i on of mass 
storage under NOS 1, and it is assumed that the reader is 
familiar with NOS mass storage concepts and the 
storage tables. The reader should refer to the 
Handbook, Sections II and IV, for review of the 
storage concepts.. 
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INITIALIZATION AND RECOVERY ROUTINES 



RECOVER MASS STORAGE (RMS) 

RMS is the deadstart portion of the MSM. It surveys all defined 
mass storage equipments and attempts to recover them. 
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RMS is activated by STL as part of the deadstart process with 
the input to RMS being the Level of deadstart recovery selected 
to be performed. With the deadstart level and information 
entered into skeletal MSTs from CMRDECK processing, the recovery 
of mass storage devices may be done. 

A flowchart of RMS is shown in Figure 8-1. There are four basic 
phases to RMS: preset, read device labels, check and recover 
devices, and call REC into execution. 



P reset 

The preset phase of RMS scans the equipment status table (EST) 
for mass storage devices, building two tables: table of 
equipments to recover CTREC) and table of CM addresses for MST 
of first unit in the equipment (TEQP) . The address of dayfiles 
to recover is also set at this time. If the system being 
deadstarted is part of a mu It ima inf rame (MMF) complex, the link 
device is examined for the existence of this machine's ID and 
its condition in order to determine whether this machine can be 
recovered or introduced to the MMF complex. 



Read Devi ce Labe Is 

Before any recovery (or initialization) can be performed, an 
attempt is made to read each device's label. This is done by 
routine read device label (RDL). The flowchart for RDL is shown 
in Figure 8-2. RDL is also called by CMS, the on-line portion 
of MSM. If the attempt to read the labels from each unit 
comprising the device is not successful, a label error status 
(STLE) is set into the MST for the device for later processing. 
If the read is not successful because a unit is not ready, a not 
ready status (STNR) is set into the MST if the device being 
recovered is removable. The attempt to read the device label is 
not made by RMS for devices with a total initialize requested. 
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Figure 8-1. Recover Mass Storage (RMS) 
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Figure 8-1. Recover Mass Storage (RMS) (Continued) 
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Figure 8-2. Read Device Labels (RDL) 
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Figure 8-2. Read Device Labels (RDL) (Continued) 
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Figure 8-2. Read Device Labels (RDL) (Continued) 
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Figure 8-2. Read Device Labels (RDL) (Continued) 
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Check and Recover Devices 

Upon the reading of device Labels, the mass storage devices are 
recovered from their active states (Level 3 deadstart) or from 
their label information (level 0, 1, and 2 deadstarts). 
Subroutine check active devices (CAD) recovers mass storage 
devices from their central memory MST/TRT. Figure 8-3 contains 
the flowchart for CAD. Subroutine check device status (CDS) 
controls the recovery of the mass storage devices using the 
information read from the device Labels in conjunction with 
information entered when processing the CMRDECK. Refer to figure 
8.4. 
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Figure 8-3. Check Active Devices (CAD) 
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Figure 8-4- Check Device Status (CDS) 
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Figure 8-4. Check Device Status (CDS) 
(Continued) 
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Mass storage devices are recovered after executing CDS by 
subroutine recover devices (RCD), provided that there are mass 
storage devices to be recovered. RCD recovers the TRT by either 
copying it entirely or editing it. The editing phase recovers 
only preserved and flawed tracks, making all other tracks 
available for system usage regardless of their previous 
reservations. The editing phase occurs only on a level 
deadstart. Figure 8-6 is the flowchart for RCD. RCD also* 
initiates the recovery of preserved system dayfiles by invoking 
subroutine chase dayfile chain (CDC), which recovers the dayfile 
by reading the mass storage device upon which it resides. 

At this point, the mass storage tables have been recovered 
either from their CM area or from the labels on the mass storage 
devices. If the system being deadstarted is part of a 
multimainframe configuration, the MSTs for shared devices are 
updated in the link device. The details of mass storage 
recovery for an MMF configuration are described later in this 
sect ion. 

If any equipments have been recovered, a verification of the 
permanent file subsystem is done. This verification, performed 
by verify permanent files (VPF), protects against duplicates in 
pack/family names and device mask bits (master devices) and 
device numbers within the same family. 



Call REC Into Execution 

Having completed this phase of mass storage recovery, the 
remainder of the system deadstart can proceed. 

RMS writes a call for PP routine REC into its input register and 
jumps to PP resident, allowing REC to be loaded and to continue 
the system recovery process. 
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Figure 8-6. Recover Devices (RCD) 
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CHECK MASS STORAGE (CMS) 

CMS is the on-line portion of the MSM. It surveys all defined 
mass storage devices and verifies that the proper devices are 
mounted or makes them available for user access if possible. 
This survey and verification takes place on a periodic basis (60 
cycles of 1SP) if removable packs are enabled (with DSD command 
or IPRDECK directive). CMS is also activated by the on-line 
mass storage initialization routines (IMS/MSI) after a device 
has been initialized on-line. UNLOAD and MOUNT commands will 
also cause 1DS to activate CMS. 

There are five phases to CMS: preset, read device labels, check 
and recover devices, check for initialization requests, and 
count active families. A flowchart of the main routine of CMS 
is shown in figure 8-7. 



Preset 



The preset phase of CMS determines if CMS is being activated 
for the first time or is being recalled. If being recalled and 
PFNL is interlocked, the interlock is requested to be cleared. 
The EST is scanned to build the TREC table in the same manner as 
RMS. 



Read Devi ce Labe Is 

The RDL routine contained in 4DB is modified to exclude portions 
of RDL that do not apply to on-line label recovery, RDL is then 
executed. RDL is flowcharted in Figure 8-2. 
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Figure 8-7. Check Mass Storage (CMS) 
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Figure 8-7. Check Mass Storage (CMS) 
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Check and Recover Devices 

This phase of CMS validates the mounted mass storage by 
verifying active devices, checking inactive and unavailable 
devices, and recovering those devices that are as yet 
unrecovered. Subroutine CAD is concerned with those devices 
that are available, not being initialized, on or off with active 
users, not removable, or removable with active users, or 
checkpoint pending and not being unloaded. If the preceding 
properties are held by the device, then verify label parameters 
(VLP) is called to validate the device. All other devices are 
not considered to be active devices. Figure 8-8 is a flowchart 
of CAD. 

Subroutine check inactive available devices (CID) is then 
executed to check those devices that were excluded by CAD and 
are removable. The MST for devices processed by CID is 
initialized and cleared of extraneous data. CID, basically, is 
the routine that cleans up the MST when a removable device is 
unloaded and restores the MST of invalid . labeled devices to a 
skeletal and unavailable condition. Figure 8-9 is a flowchart 
of CID. 

Subroutine check unavailable devices (CUD) processes those 
devices not previously validated by CAD or not unloaded by CID 
(these should be all devices not active and verified that have 
an unavailable status). CUD determines if there are any devices 
to recover. A flowchart of CUD is shown in figure 8-10. 
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Figure 8-8. Check Active Devices (CAD) 
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Figure 8-8. Check Active Devices (CAD) (Continued) 
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Figure 8-9. Clear Inactive Devices (CID) 
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Figure 8-9. Clear Inactive Devices (CJD) (Continued) 
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Figure 8-10- Check Unavailable Devices (CUD) 
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If after executing CAD, CID, and CUD, a device is to be 
recovered, subroutine RCD is called. Subroutine RCD performs 
the same function for CMS as the RMS subroutine. A verification 
of the permanent file subsystem is performed as in RMS. 

Check for Initialization Requests 

After recovering and verifying existing mass storage devices, a 
check is made to see if there is an initialize request pending 
for any of the mass storage devices. If initialization requests 
are present, then CPU routine MSI is activated to process the 
initialization. The control statement MSI. is entered into 
control statement buffer of the control point and 1AJ is called 
to process the next statement. This activity is performed in 
subroutine check ini t i a I i zat i on request CCIR) and is flowcharted 
in Fi gure 8-1 1 . 

Count Active Families 

If no initialization requests were present and the permanent 
file system has not been verified, VPF is called. If the count 
of active families detected by VPF does not agree with the 
family count in PFNL, then the family count is updated in PFNL 
using monitor function IAUM with option IPFS or DPFS to increase 
or decrease the family count. 



Once this phase has been completed, 
its PPU. 



CMS terminates by dropping 
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SYSTEM RECOVERY PROCESSOR CREC) 

The third component of mass storage recovery is REC. REC 
performs many recovery functions but is mentioned in this 
section only for those activities dealing with the recovery of 
mass storage, namely the recovery of preserved files. REC loads 
overlay 4DA (which is part of MSM) to recover preserved files; 
this includes input/output queue files, and direct access 
permanent files. If a dayfile is not recovered, REC will 
establish a new one. 



MASS STORAGE RECOVERY IN MMF ENVIRONMENT 

For purposes of device usage determination, tables are 
maintained in ECS that identify the status of all devices in 
the mult imainf rame complex. This includes shared and nonshared 
devices for all machines. These tables are called the device 
access tables (DAT). 

RMS and CMS use similar logic in recovering mass storage devices 
When a device is recovered, the DAT is interlocked while a 
check is made to see if an entry exists for this device. The 
presence of an entry indicates that another machine is also 
accessing the device. If an entry is found and the machine 
recovering the device has not been instructed to share it, an 
error is indicated and recovery halts with an appropriate 
message displayed. If the machine already accessing the device 
is not allowing it to be shared (TRT is not ECS-res ident ) , the 
same error condition occurs. These situations are illustrated 
i n tab le 8-1 . 
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TABLE 8-1. RECOVERY OF SHARED DEVICE ERRORS 



\ Status 
\ 
\ 
A 
V 
Status \ 
\ 



Devi ce Used i n 
Nonshared Mode 



Devi ce Used i n 
Shared Mode 



U s e Device 
in 

Nonshared 
Mode 



ERROR 

Two machines want to 
use the same device 
in nonshared mode. 



| ERROR 

I 

| Machine coming up wants 

| to use a device in 

I nonshared mode that 

I other machines are 

| shari ng . 



Use Devi ce 
in Shared 
Mode 



ERROR 

Machine comi ng up 
wants to use a device 
in shared mode that 
another machine is 
using in nonshared 
mode. 



Add accessing status 
to DAT. 



The statuses across the top indicate in which mode the device is 
being utilized. The statuses down the Left side indicate in 
which mode a machine coming up wants to utilize the device. 

When a machine recovers a device it adds an indication to the 
DAT entry, -if the indication does not already exist, that this 
machine has accessed (recovered) this device. 

If the device is shared and another machine has it interlocked, 
a bit in the DAT is checked to determine if a level type 
recovery is in progress on the device. Once the recovery is 
completed, recovery on this machine proceeds as indicated. It 
is not allowable to attempt a nonlevel recovery on an 
interrupted machine once the recovery utility is run on another 
machine to recover the mass storage space of the interrupted 
machine. When RMS recovers a device on a nonlevel deadstart, 
the DAT indicates that this machine has accessed the device 
previously. This status is cleared by the machine recovery 
utility. 
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It is the responsibility of each machine to recover its own 
local FIST area off of the device. A bit in the global portion 
of the MST indicates if the sector of local information exists. 
In any event, if the local area that exists in the label sector 
matches the machine ID of the recovering machine, that local 
area is assumed to be the most up-to-date, regardless if 
information also exists in the sector of local areas. 

If no entry for the device to be recovered exists in the DAT, an 
entry is made by RMS. A flag register interlock is set to 
prevent other machines from attempting the same. Once recovery 
is completed, the flag register interlock is cleared by REC. 

Table 8-2 shows the steps involved for mass storage device 
recovery during the various levels of deadstart. When a device 
is not shared with any other mainframe, it is termed a 
standalone device. If the device is shared, t he DAT is 
interrogated and recovery proceeds differently depending on 
whether it is active (in the DAT) or not active (not in the DAT) 
Another criterion that denotes which steps are taken is the 
machine mask field in the DAT which indicates whether or not the 
device has been accessed previously by this machine. Removable 
devices recovered on-line are handled the same as devices on a 
leve I deadstart . 



TABLE 8-2. MASS STORAGE DEVICE RECOVERY DURING DEADSTART 



I Device Type 


of | Standalone | Shared-Not Active! Shared - Active 
Dead- j Device | (Not in DAT) | (In DAT) 


| * | •* | * | ** | * | *• 


|2,4,6, | Not |1,4,6, | Not I 3,11 |11,12,13 
|7,8,14 j appli- |7,8,9, | appli- j | 
I | cab le 1 1 0,1 4 | cab le | | 


1 and 2|2,4,7 | 4,7 H,4,5, | Not I 3,11 |11,13 
I I 1 7,9 | appl i - I I 
I I I | cable | | 


3 lError ] 4,7 lError | Not I Error |11,13 
I I I I app I i- I I 
I I I | cable | I 



* Device not accessed previously 
** Device accessed previously 
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The numbers in table 8-2 indicate the following. 

1. DAT entry not found; make DAT entry that indicates that 
this machine only is currently accessing the device. 

2. DAT entry not found; make DAT entry which shows that 
this machine is accessing the device but has no MST 
pointer (not shared). 

3. Add indication to existing DAT entry which shows that 
this machine is accessing the device. 

4. Retrieve MST (all local and global portions) from the 
device and, if shared device, preset into ECS. Retrieve 
TRT from devi ce. 

5. Set MRTs from device into ECS. 

6. Edit TRT (that is, release all track chains except the 
preserved file chains). 

7. Clear track interlocks for all machines. 

8. Clean up system sectors (interlocks and user counts) for 
all mach i nes . 

9. Set TRT from device into ECS. 

10. Clear MRTs for all machines. 

11. Retrieve TRT and global MST from ECS. Get local MST 
from device. Clean up local MST (clear interlocks, 
reservations and request statuses). 

12. Process MRT for this machine and drop local tracks. 

13. Process MRT for this machine and clear track interlocks. 

14. Build file of inactive queued files. 



MSM OVERLAYS 

MSM contains the CMS and RMS main programs and overlays that are 
used by CMS and RMS and by REC as well. The overlays of the MSM, 
and for mass storage recovery in general, have the name 4Dx. In 
the descriptions that follow, the mass storage recovery overlays 
are de tailed. 
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OVERLAY 4DA/RDA 

The main routine of 4DA and RDA is f lowcharted in Figure 8-12. 
RDA processes preserved track chains recovering input/output 
queue files and direct access permanent files. If QPROTECT is 
enabled, the IQFT file is built from the input/output files 
recovered. Other subroutines in 4DA include: 

CDA Determines if a track isp art of a preserved chain 

CQF Creates an IQFT entry for a recovered input or output 
queue file 

IQF Creates the system sector for the IQFT file 

TQF Completes the IQFT file (if queues were recovered), 
causing the IQFT first track to be set in word ACGL 
of the MST and checkpoints the device if the IQFT is 
not empty 

VFL Verifies that the file is as long as the track chain 
for the file indicates 

WQF Writes individual sectors of the IQFT as the IQFT 
buffer becomes full 

IDM Issues the following messages: 

EQee xxxx DIRECT ACCESS FILES RECOVERED. 

EQee xxxx PRESERVED FILE ERRORS. 

EQee xxxx DIRECT ACCESS FILE ERRORS. 

EQee xxxx QUEUED FILES RECOVERED. 

EQee xxxx QUEUED FILE ERRORS. 

EQee xxxx QUEUED FILES IGNORED. 
PFE Formats the permanent file length error message 
BAD Compute IQFT buffer address 
CFL Change file Length 
I EM Issue error Log message 
RDC Readdiskchain 
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VSL Validate sector linkage 

VTC Verify track chain 

IRM Issue recovery messages 

CEA Convert ECS address 

CTU Clear user counts 

GDE Get DAT entry from ECS 

WDE Write DAT entry to ECS 
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Figure 8-12. Overlay 4DA/RDA 



60454300 B 



8-40 




display message 
RECOVERING 
EQxxAyyyy 





Figure 8-12. Overlay 4DA/RDA 
(Continued) 
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Figure 8-12. Overlay 4DA/RDA 
C Cont i nued) 
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Figure 8-12. Overlay 4DA/RDA 
(Cont i nued) 



60454300 B 



8-43 



OVERLAY 4DB 

The primary routine of 4DB is RDL (read device Labels), which is 
flowcharted in figure 8-2. Other subroutines in 4DB are: 

MRL Provides Looping control for subroutines that must be 
executed once for each device being processed 

CLR Clears the TRT, preserving only those tracks that have 
been previously flawed 

CMT Clears the MST words ALGL and DULL; initializes MDGL, 
STLL, and ACGL; and calls CLR 

IES Initializes the equipment status fields in MST word 
STLL by building the equipment chain values for this 
devi ce 

SSL Sets the sectors per track values in MST word MGDL 
depending upon the number of units in the equipment 

RLM Reads the local MST from sector of Local areas if the 
local MST is not the correct MST for the machine ID 

SPP Sets the permanent file attributes of the device into 
the MST from the label of the device; converts 
permanent file information from predecessor systems 
into the current NOS format of this data 

WMT Writes the MST from the working buffer in the PP into 
the MST area of central memory for the device 

CEA Convert ECS address 

SNT Set next track in DAT chain 

WDE Write DAT entry to ECS 

CAM Change access mode (half/full track or full/half track 
for LDAM devi ces 

C FT Clear full track access 

SFT Set full track mode for LDAM device 

SHT Set half track mode for LDAM device 

RLS Read label track 

SLT Search for label track 

CSD Returns to its caller a status indicating the 

condition of the DAT with respect to this device 

CDE Check DAT ent ry 
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RDE Read OAT entry from ECS 

SDT Search DAT 

UDT Update DAT in ECS 

LDT Load DAT from ECS 

OVERLAY 4DC 

The subroutines in 4DC are: 

VPF Determines on a family basis that the mounted members 
of the family have unique device numbers and do not 
duplicate master device mask bits 

CAN Builds a table of family names currently mounted 

C FN Compare, family/pack names 

GNE Get next entry from MS EST 

ERR Issues one of the following diagnostics: 

EQxx EQyy CONFLICTING DN 

EQxx EQyy CONFLICTING PN 

EQxx EQyy CONFLICTING UM 

and calls 4DB/IES to set the appropriate error code in 
the MST. 



OVERLAY 4DD 

The primary subroutine of 4DD is IDF (initialize dayfiles) which 
is flowcharted in figure 8-13. The other subroutines in 4DD 
serve entirely as subordinates to IDF. Overlay 4DD is assembled 
as part of REC and is included for completeness of 4Dx overlays. 
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Figure 8-13. Initialize Dayfiles (IDF) 
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Figure 8-13. Initialize Dayfiles (IDF) 
(Continued) 
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Figure 8-13. Initialize Dayfiles (IDF) 
( Cont i nued) 
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OVERLAY 4DE 

The subroutines in 40E manipulate the user ECS chain. This 
chain is a contiguous track chain which is then used as an area 
to allocate user ECS blocks. The routines are: 

ECS Main routine to allocate/ recover user ECS area 
ACE Assign contiguous ECS tracks 

CAD Clear allocation data in system sector for specified 
mach i ne ID 

CDI Clear device interlock on ECS 

FAD Fetch allocation data for specified machine ID from 
system sector 

FSS Fetch system sector for user ECS chain 

FTM Find area for this machine's subchain in system 
sector 

HNG Issue message and hang 

ISS Initialize system sector for user ECS area 

RLS Release existing user ECS subchain 

SCP Set up control point areas for access to ECS 

SDI Set device interlock on ECS equipment 

SSS Write system sector for user ECS chain 

To support user ECS, a contiguous track chain is reserved by 
routines in overlay 4DE. This chain is split into subchains 
that are used by machines in an MMF environment which have 
machine IDs that match the ID on the subchain. The information 
describing the subchains is written in the system sector of the 
user ECS chain. The user ECS system sector format is shown in 
section 2. 
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OVERLAY 4DF 

The subroutines in 4DF manipulate MMF tables contained in ECS. 
These routines are: 



EDT 
UER 

CRT 
ERT 
SMT 



Builds the DAET word in ECS 

Clears or enters machine recovery tables (MRTs) 
for the device in ECS 

Clears the MRT of this device 

Edits the MRT 

Stores the MRT and TRT into ECS 



OVERLAY 4DG 

Overlay 4DG contains routines for manipulating track reservation 
tables. TRTs are read into central memory area separate from 
where they reside with the MST for recovery operations. The 
major routines of 4DG are: 



ATC 



EMT 



ETT 



RTT 



SEC 



CCE 



CLP 



Adjusts the track count (number of tracks remaining) 
in word TDGL of the MST. 

Updates the MST and EST to indicate that the device 
is available updating MST words ACGL, MDGL, DULL and 
the PF descriptors A L G L , PFGL and PUGL, 

Edits the labels from the recovery buffer in central 
memory to the TRT area, releasing all track chains 
that are not preserved or flawed. 

Reads the TRT into the recovery buffer in central 
memory from its position in the device's label track 

Sets the equipment configuration by indicating 
whether a device is part of an equipment chain. 
While part of an equipment chain, the MST/TRT of the 
first device in the chain is the primary source of 
information for the chain. 

Validates the equipment chain to verify that the 
elements of the chain are correctly linked. 

Compares a set of label parameters consisting of 
pack name, user number, and number of units with a 
desired set of these values. 
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OVERLAY 4DG (continued) 



VLP 



RTC 
AUL 
CEP 
VDP 



Validates Labels read for a given equipment chain. 
All devices in the chain must be ready and have 
correctly read labels as well as satisfying the 
desired set of pack name/user number/number of unit 
properties- VLP calls CLP and CCE. 

Reserve track chain. 

Assemble unit List. 

Compare equipment parameters. 

Verify device parameters. 



OVERLAY 4DH 

Overlay 4'DH contains routines utilized by RMS in initializing 
mass storage equipment. The primary subroutine of 4DH is IDS 
(initialize device status), which is flowcharted in figure 8-13.1 
The other subroutines in 4DH, which are entirely subordinate to 
IDS, are the following. 



CTF 
IFM 

PFT 
RCS 



Check track flawed in TRT. 

Interpret flaw map. This routine uses overlay OTI 
to read the factor flaw map on 844 and 885 type 
devices and sets the flaws in the TRT. 

Prewrite flawed track. Prewrites any potential 
label that is flawed. 

Reserve CTI space. This routine reads the 
deadstart sector, checking for the presence of 
CTI/MSL, and flaws those areas of the TRT 
accordingly. 



MSM OVERLAY LOAD ADDRESSES 

Figure 8-14 details a load map of MSM. The load addresses of 
the various overlays of MSM ape defined as follows: 

Def i ni t ion 

Maximum of /CMS/PRSX+5 and OCTL+5 

NMSD + maximum of /CMS/PRSX and 
/RMS/PRSX 

End of common subroutines in 4DB 



Rout i ne 


LOe 


id Adc 


Iress 


4DA 




04DA 




4DB 




04 DB 




4DC 




OSOV 




4DF 
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4DG 




OSOV 
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Figure 8-13.1. Initialize Device Status (IDS) 
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Figure 8-13.1 



Initialize Device Status (IDS) 
( Cont i nued) 
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Figure 8-14. MSM Load Map 
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Table 8-3 shows a cross-reference of the main routines CMS, RMS, 
and REC and the overlays that they call. 



TABLE 8-3. MSM CROSS REF ERENCE 



j Overlay I 


CMS I 


RMS | 


REC 


| ADA 1 


x .1 




X 


| 4DB 1 


X 


x 1 




I 4DC I 


x.. ■! 


x . .1 




I 4 D D 






X 


| 4DE 






X 


| 4DF 


x 


x 




| 4DG 


X 


x 




| 40 H 




!■ X" .' 




| others 


I OP I 




| OCI 






| OMF 


| ODF 
| OP I 
1 Q'.R.F 



DEVICE CHECKPOINT 

The information written on a mass storage device, whether during 
an initialization or during usage, is kept accurate by the means 
of a checkpoint. The term checkpoint in this section refers to 
those checkpoints that update the label track of the device. 
The success of a recovery operation depends almost entirely upon 
how accurately the information in the device label reflects the 
actual usage of the device. A checkpoint operation updates the 
MST and TRT information contained in the device label from the 
MST/TRT active in central memory. 
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There are six types of checkpoints: 

• A deadstart checkpoint allocates system table space and 
copies the tables to mass storage, checkpoints the TRT on 
system devices, and checkpoints local areas on devices 
with active dayfiles. 

• A system checkpoint idles the system and checkpoints 
system tables and TRTs. 

• A device checkpoint checkpoints the TRT for all devices 
with checkpoint requests set. 

• An alternate library checkpoint performs the same 
function as a system checkpoint without idling the 
system . 

• A local area checkpoint copies the Local MST information 
of a device to the local area sector. The TRT on that 
device is also chec kpoi nt ed . 

• An initialized device checkpoint performs the same 
function as a device checkpoint, except the call has been 
initiated by IMS for a single device. 

Checkpoints are performed by P-P routine 1CK. For device 
checkpoints, 1CK is called from 1SP. Routine 1SP examines the 
MST for mass storage equipments every 30 cycles (about 30 
seconds) and calls 1CK if the checkpoint bit is set in STLL. 

The major concern for mass storage recovery is the device 
checkpoint. The device checkpoint writes the current EST and 
MST in the label sector and copies the entire TRT to the label 
track. Refer to Section 2 for the format of these areas of mass 
storage. For all checkpoints, the TRT is written to the label 
track; this TRT checkpoint is the last operation performed in a 
checkpoint in order to guarantee the accuracy of the TRT. The 
flowchart for the TRT checkpointing routine WTT is shown in 
figure 8-1 5 . 
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Figure 8-15. Write TRT (WTT) 
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Figure 8-15. Write TRT (WTT) 
( Cont inued) 
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ON LINE RECONFIGURATION OF RMS 

On-line reconfiguration of devices is handled by two routines, 
RDM (redefine mass storage) and CONFIG (configure mass storage). 
RDM handles the actual device reconfiguration and table 
interlocking. CONFIG supp li es the operator interface via a 
K-display for al I i nt eract ions required while redefining a 
device. The redefinition process is initiated by the DSD entry 
REDEFINE, eq. This entry starts a sequence which calls CONFIG to 
a control point for the actual reconfiguration process. 



ROUTINE RDM 

The RA+1 call to RDM has the following format. 



59 



35 



RA + 1 



RDMP 



function 
number 



23 



17 



status word 
address 



That status word is necessary for all of the RDM functions 
Following is a list of the functions with the status word 
contents upon entry and the reply, if any, upon exit. 



Function 1 - Search for Outstanding Requests 



59 



reply 



47 



eq 



eq 



EST ordinal of first shared equipment having 
reconfiguration reply machine masks in word ACGL; 

4000B if no reconfiguration reply machine masks found 
on any shared equipment 



Function 2 - Replace Uni t 



entry 



59 


35 


23 


11 





dp 


au 


eq 
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Function 3 - Add Unit 



entry 



59 




47 




35 




23 




11 










ch 


up 


au 


eq 



Function 4 - Delete Unit 



59 



entry 



23 



11 






dp 


eq 



Funct ion 5 - C Lear Request 



59 



11 



entry 



eq 



Function 6 - Ignore Processing of Device 



entry 



reply 



59 




47 






11 










eq 


rep 






rep 4000B if redefinition requested bit set; 
if not set . 



The following mnemonics describe the parameters in the above 
en,try conditions. 

ch Channel(s) for the unit to add 
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up Unit position of the unit to add 

au Unit to add to the unit list 

dp Unit position of the unit to delete 
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The message VERIFYING EQxx DNyy is now displayed on all machines. 
By use of the RD pseudo equipment and the standard driver, RDM 
then verifies that the correct pack has been mounted on the unit 
by verifying the pack label. This verification is performed on 
each channel connected to the device, verifying on the channels 
in ascending order. After verification, the fields in the pseudo 
equipment EST and MST are reset. 



i s 



If an unrecoverable read error is detected while reading the 
label on any channel, the message LABEL READ ERROR/ENTER STOP 
flashed to the operator. In this case, all machines in the 
complex must enter STOP to begin the return to original 
configuration operation. If the verification of the label on one 
machine is not valid, the message LABEL VERIFICATION ERROR is 
displayed on that machine. If this message appears on all 
machines in the complex, the units should be spun down and the 
physical packs checked to insure that the correct packs were 
switched. If the wrong packs were switched, the correct switch 
should be made and normal operations continued. If the correct 
switch had been made, or if the error message appeared on only 
some of the machines in the complex, all the machines should 
enter STOP to initiate the return to original configuration 
operation. 

On the return to original configuration operation, the return 
switch of the packs is monitored, flashing the messages SPIN DOWN 
UNIT y, SPIN DOWN UNIT x, and RETURN PACK TO UNIT x, as 
necessary, to the operators. If the return verification is good 
and no unrecoverable read errors were encountered, the 
reconfiguration reply machine masks- are cleared, the redefinition 
requested and redefinition in progress bits cleared, the message 
EQxx REDEFINITION ABORTED issued to the error log, and the 
reconfiguration runs aborted. 

If the return verification cannot be completed, the message 
RETURN ERROR/ENTER OVERRIDE is flashed on the display and each 
machine has to enter OVERRIDE, causing the masks and bits to be 
cleared, the error log message issued, and the reconfiguration 
runs aborted. 

On normal operations with no errors, as each machine verifies 
the label, they clear their own reconfiguration reply machine 
mask in word ACGL of the global MST and then loop, waiting for 
the redefinition requested bit to be cleared. The machine which 
clears the last reconfiguration reply machine mask also clears 
the redefinition requested bit. The current unit number with 
the unit position specified in the status word is then replaced 
in the unit list in word DDLL of the MST by the replacement unit 
number from the status word. The redefinition in progress bit 
is then cleared in each machine. 



60454300 B 



8-60 



NOTE 

The DSD STOP command may be entered at any time 
during the reconfiguration run if it is decided 
that the reconf i gurat i on i s not wanted. 
Necessary clean-up procedures are initiated 
' automatical Ly when STOP is detected at various 
points within the routine. Aborting a switch pun 
causes the replacement unit to be left undefined 
(not in the EST) . 

When called in single mainframe mode or MMF mode on a nonshared 
device,' -the replace unit function sets the redefinition in 
progress bit. The operator is instructed to spin the units down 
and switch the phys i ca I packs and the pack is verified. Finally, 
the redefinition requested bit is cleared, the current unit 
number replaced in the unit list by the replacement unit number, 
and the redefinition in progress bit cleared. All error 
processing remains the same as in MMF mode on a shared device 
(described in pevious paragraph). When the call is in MMF mode on 
a nonshared device, the machine will have and hold the DAT 
interlock throughout the entire reconfiguration run. 

NOTE 



When function 2 has redefinition in progress 
set, no additional PP calls or overlay loads 
may be processed and no dayfile messages issued 
by RDM until the operation is complete. 
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The clear reconfiguration run function (function 5) reads the 
equipment number from the status word and clears the redefinition 
requested bit in word ACGL of the MST. If running in MMF mode, 
this function should be called through the use of the CLEAR 
command only if all processing on the specified equipment is 
completed. If it is decided that no machine wishes to execute 
the reconfiguration on the given equipment, whether MMF or not, 
the CLEAR command must be used to clear out the redefinition 
requested bit. 

The ignore processing on device function (function 6) reads the 
equipment number from the status word, clears the DAT interlock 
if it is held by this machine, and then checks, the redefinition 
reqested bit. If the bit is set, the reply of 4000B is sent to 
CONFIG. This function is called repeatedly until the bit is 
found to be clear, in which case a reply is returned to CONFIG. 



DEVICE REDEFINITION LOGIC FLOW 

A device redefinition sequence would follow the following 
sequence. 

1. Enter DSD entry REFEDINE, eq. This sets redefinition 
requested status for equipment (eq) MST word (ACGL bit 
11) . 

2. 1SP during its periodi c .execution checks for bit 11 in 
ACGL. If the bit is encountered the CMS call sequence 
executes . 

3. CMS detects the redefinition requested status, obtains 
the DAT interlock (if required due to MMF operation), 
and calls CONFIG. 

NOTE 

The 1SP, CMS logic enables the redefinition 
programs to run as part of the MS subsystem. 

4. CONFIG scans the MSTs looking for redefinition 
requested bits set and builds a list of these 
equipments. 

The following is the sequence CONFIG and RDM follow while 
replacing or switching units on a shared device in a MMF 
environment, RDM function 2 does not drop out until the 
reconfiguration completes. 

5. The first machine to obtain the DAT interlock (machine 
A) calls RDM to scan through the MSTs of all shared 
devices. When RDM finds that none of these MSTs contain 
reconfiguration reply machine masks in word ACGL (bits 
7 to 10), it returns a reply of 4000B to CONFIG. 
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When CONFIG receives the 4000B reply it gets the first 
equipment to be reconfigured from its List, displays 
the current configuration for that equipment on the K- 
display, and accepts and veri fies input parameters for 
the reconfiguration of this equipment. 

CONFIG calls RDM to process the reconfiguration request 
on machine A when the GO command is entered. RDM sets 
the redefinition in progress bit (DDLL bit 59). This 
insures that any PPs accessing the device execute the 
LDAM function and get not ready status. 



RDM on machine A 
mask for machine 
response from ot 
this by drop pi ng 
checking for the 
the other ma chin 
found i n the DAT 
obtains the DAT 
sets up the K-di 
scan the MSTs of 
re ply. machine ma 
bei ng processed 
reconfiguration 
ACGL and returns 
CONFIG. 



sets the reconfiguration r 

A in word ACGL and waits f 
her machines in the complex 

the DAT interlock and loop 

reconfiguration reply mach 
es that are accessing the d 

entry). Meanwhile, CMS in 
interlock and calls CONFIG, 
splay on machine B and call 

shared devices for reconfi 
sks. When it comes across t 
by machine A, it finds the 
reply machine mask of machi 

the equipment number (EST 



ep ly mach i ne 
op the 

It does 
ing, 

ine masks of 
evi ce (as 
machine B 

CONFIG 
s RDM to 
gurat i on 
he device 

ne A in word 
ordi na I) to 



9. CONFIG on machine B now accepts and processes 

K-display input and calls RDM when GO is entered. RDM 
se.ts the redefinition in progress bit and sets the 
machine B reconfiguration reply machine mask in word 
ACGL. Next, it drops the DAT interlock and begins to 
loop in the same manner as machine A. 

10. When all machines in the complex that are accessing the 
device concur with the replace or switch, having 
entered their reconfiguration reply machine masks in 
word ACGL, the messages SPIN DOWN UNIT x and SPIN DOWN 
UNIT y are flashed to the operator on the B display as 
necessary until the unit to be replaced and the unit 
replacing it are both spun down. Then the message 
SWITCH PACK/SPIN UP UNIT y is flashed on the display. 

11. RDM on each machine monitors the pack switch to insure 
that the correct pack is mounted on the correct unit. 
While monitoring the switch, the pack label is 
validated. Each machine clears their own 
reconfiguration reply machine mask after they have 
validated the label. After clearing this bit they loop, 
waiting for the redefinition requested bit to be 
cleared. The last machine to clear its own 
reconfiguration reply machine mask then clears the 
redefinition requested bit. 
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12. Once the redefinition requested bit is cleared, each 
machine sets the new unit number in the unit List in 
word DDLL and clears their redef ini.t i on ' in progress 
bit. This allows the system to access the device. 
Control is then returned to CONFIG on all machines and 
the reconfiguration runs proceed as in step 5. 

The following is the sequence CONFIG and RDM follow while 
replacing or switching units on a nonshared device in MMF mode, 
or any device in single mainframe mode. If. reconfiguring a 
nonshared device in MMF mode, the machine will have and hold the 
DAT interlock throughout the entire reconfiguration. 

5. CONFIG accepts and verifies the K-display input. When 
GO is entered, RDM processes the request. The channels 
connected to the device are attached, the redefinition 
in progress bit is set. 

6. The SPIN DOWN UNIT x, SPIN DOWN UNIT y, and SWITCH 
PACK/SPIN UP UNIT y messages are flashed to the 
operator on the B display as necessary. 

7. RDM monitors the pack switch and the pack label is 
validated. The redefinition requested bit is then 
cleared, the new unit number set in the unit list and 
the redefinition in progress bit cleared. The system 
now is allowed to access the device. 
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COMBINED INPUT/OUTPUT 



USER/CIO INTERFACE 
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Figure 9-1. User/CIO Interface 

The FET formats for mass storage and magnetic tape files are 
described in detail in the NOS Reference Manual, Volume 2 (refer 
to preface for pub li cat ion number) . 



60454300 B 



9-1 



Equipment which may be accessed by CIO includes: 

Mass storage (MS) 

Magnetic tape CMT or NT) 

Time-sharing terminals (TT) 

Card reader (CR)* 

Card punch CCP)* 

Line printer CLP, LR, LS, or LT) * 
Routines used by CIO include: 

OBF - Begi n f i le 

ODF - Drop file 

2LP - Write line printer * 

2PC - Write card punch * 

2RC - Read card reader * 
CIO consists of the following overlays: 

CIO - Main routine and termination 

2CA - Identify special request 

2CB - Read mass storage 

2CC - Special mass storage reads 

2CD - Write mass storage 

2CE - Special mass storage writes 

2CF - Position mass storage 

2CG - Close mass storage 

2CH - Terminal input/output 

2CI - Magnetic tape operations 

2CJ - Multifile label processor 

2CK - Error processing 

2CL - Issue dayfile message 



* On-line drivers for these equipments are part of the 

maintenance package. They are referenced in this section for 
completeness only. 
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The call to CIO is formatted as follows: 

59 40 35 17 

RA+1 



CIO 



\ 







addr 



r Autoreca 1 1 bi t 

n Count for skip oprations 

addr Address of the FET 



CIO MEMORY ALLOCATION 
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by CIO is dependent upon the 
rious functions required by the 
y c a s e s , two overlays are associated 
ormed; for example, write mass 
e writes (2CD/2CE), and magnetic tape 
rocesso.r. (2CI/2CJ). In other cases, 

read or write overlay; for example, 
In these cases, the load address is 
nal overlays must also be loaded, 
y (2CK) is loaded at the next address 

simultaneous overlay residence has 
processing overlays are not disturbed 



Table 9-1 associates origin (load) addresses with the 
various overlays and the def i ni t i on of the origin addresses. 



Figure 9-2 illustrates PP memory as allocated by CIO. 
9-3 illustrates the CIO main overlay. 



Fi gure 
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TABLE 9-1. ORIGIN ADDRESSES 



Rout i ne 



Origin 



Definition 



2CA 
2CB 
2CC 
2CD 
2CE 
2CF 



2CG 

2CH 
2CI 
2CJ 
2CK 
2CL 
2CP 
2PC 
2RC 



OVL 

MS DO 

ERMS 

MSDO 

EWMS 

PMSO 



CLOO 

DRFW 

OVL 

EMTO 

ERPO 

IDMO 

DRFW 

DRFW 

DRFW 



End of tables and overLayable subroutines 

End of CIO resident subroutines 

End of 2CB 

End of CIO resident subroutines 

End of 2CD plus track table 

Maximum (end of 2CD, end of 2CB); this is 

not maximum (ERMS, EWMS) since EWMS 

includes the track table and PMSO does 

not 

Maximum (EWMS, amount loaded in PRUs for 

2CD) 

Defined as 2000B in COMSCIO 

End of tables and overLayable subroutines 

End of 2CI 

Maximum ( E W T , ERDO, end of 2CF) 

ERPO plus end of subroutine /ERP/IMR 

Defined as 2000B in COMSCIO 

Defined as 2000B in COMSCIO 

Defined as 2000B in COMSCIO 
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PPFW 

MSDO 
DRFW 



PP 
RESIDENT 



termination routines, 
resident processors, 
resident subroutines 



TABLES 



OVL 



CIO overlayable 
subroutines 



BUFF 



7777 




Figure 9-2. CIO PP Memory Allocation 
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PPFW 



MSDO 



OVL 



UFS - Update file status 

RRF - Reset random FET pointers 

IOF - Set IN=OUT=FIRST 

CFN - Complete function 

ERR -Process error 



CNR - Complete null read 

D-RF - Drop f i le 

REW - Rewind mass storage 

MSP - Complete MS processing 

CAF - Compute absolute FET address 

DCC - Drop channel when output 

regi ster c lea r 

IMS - Initialize mass storage 

MSR - Process MS error 

TREQ - Request codes 

TRDO - Read processors 

TWTO - Write processors 

TFCN - Function equipment processors 

EFN - Enter file name 

FMS - Function mass storage 

FUE - Function unknown equipment 

RUE - Read unknown equipment 

SSC - Set skip count 

WUE - Write unknown equipment 



CI01 - Read buffer status 

IRQ - Identify request 

SAF - Search for f i le 

SFS - Set file status 

CFA - Check file access 

CBP - Check buffer parameters 

PFN - Process function 



Termi nation 
rout i nes 



Resident 
processors 



Resident 
subrout i nes 



Tab les 



CIO 
subrout i nes 



Initialization 



Figure 9-3. CIO - Main Overlay 
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CIO INITIALIZATION ROUTINES 

Figures 9-4 through 9-10 are flowcharts for the following CIO 
initialization routines; 

CI01 /IRQ 

SAF 

EFN 

SFS 

CFA 

CBP 

PFN 
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clear FST 
address (FA), 
random func- 
tion (RF), 
physical 
record count 

(PC), set 
driver recall 
code (RG) 



read buffer 

status, 

FIRST and 

LIMIT 





advance to 
next entry 
in TREQ 



identify 
request 




yes 



EXR 



identify 
special 
request 



ISR 



argument 
error 




no 



save level 

number and 

binary/coded 

bit 



SAF 



initialize 

for search 

of TREQ 




yes 




IRQ5 



Figure 9-4. CI01/IRQ - CIO Initialization 
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yes 




read FNT 
pointer 
(FNTP) to 
FS - FS+4 




compare file 
names and 
control 
point numbers 




no 




read next 

FNT entry 

into CM 



set FST 
pointer 

— *» FA 





no 




EFN 



enter 
new 
file 
in FNT 




Figure 9-5. SAF - Search for Assigned File 
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( EFN J 



clear FST 

address in 

FA and equip 

assignment 
in FS 




file name 
error 



Figure 9-6. EFN - Enter File Name 
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clear FST 

address 

(FA) 





ERR 



file 

sequence 

error 



read FNT 
entry CM 




CFA 




ERR 



local file 
limit error 



Figure 9-6. EFN - Enter File Name (Continued) 
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store FNT 
entry in 
MB for 
monitor 



read FST 
entry — > FS 
FNT entry 
— > CM 



CFA 





ERR 



file 

sequence 

error 



Figure 9-7. SFS - Set File Status 
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V 

save upper 
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completion 

routine 



K3FA5J 



store EQ 
type in PFN 
routine in 
FCB 



I/O on execute 
only file 



EXO 
ERR 




clear 

random 

bit 



RUD 
ERR 



pick up 
EQ type 
from EST 
entry 





RUD J request undefined 
ERR j on device 



Figure 9-8. CFA - Check File Access 
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set write 
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table address 
TWTO > FCA 



IWR 



write on 
read only 
file 



set function 
table 
address 
TFCN > FCA 




Figure 9-8. CFA - Check File Access (Continued) 
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FET +6 




» GBP < 



Figure 9-8 
60454300 A 



CFA - Check File Access (Continued) 
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Entry - FIRST and LIMIT already read by CI01 




buffer 
argument 
ror 



Figure 9-9. CBP - Check Buffer Parameters 
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search table 

for matching 

equipment 





clear error 
processing 
flag (ep bit 
in FET+1) 



set track 
interlock 




no 



> CFN 




(A) = overlay 
selected to 
process 
function 
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load and 
execute 

overlay 



UFS 
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jump to 
resident 
routine (FMS, 
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-»(PFN4J 



Figure 9-10. PFN - Process Function 
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The PFN routine searches one of three tables (TRDO, TWTO, or 
TFCN) to get the name of the overlay to be executed. The three 
tables are formatted as shown in tables 9-2 through 9-4. 



TABLE 9-2. TRDO - TABLE OF READ PROCESSORS 



Equi pment 


Entry P 


oi 


nt 


Overlay Name 


MS 


RMS 






2CB 


TT 


TIO 






2CH 


MT 


PMT 






2CI 


NT 


PMT 






2CI 


CR 








2RC 





RUE 






(Resident-read un- 
known equipment) 



TABLE 9-3. TWTO - TABLE OF WRITE PROCESSORS 



Equi pment 


Entry Point 


Overlay Name 


MS 


WMS 


2CD 


TT 


TIO 


2CH 


MT 


PMT 


2CI 


NT 


PMT 


2CI 


LP 




2LP 


CP 




2PC 





WUE 


(Resident-write un- 
known equipment) 
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TABLE 9-4. TFCN - TABLE OF FUNCTION PROCESSORS 



I I 

Equipment | Entry Point I Overlay Name 



MS 
MT 
NT 



FMS 
PMT 
PMT 
FUE 



(Resident) 

2CI 

2CI 

(Resident -functi on 
unknown equipment) 



CIO ERROR MESSAGES AND ROUTINES 

Error messages from CIO are numbered and identified by a unique 
three-character name. Subroutines issuing an error message do 
so with the following code. 



LDN 
LJM 



AERR/xxx 
ERR 



All error messages are in overlay 2CK (table 9-5) 
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TABLE 9-5. OVERLAY 2CK 



Name 



Message 



ARG 
BLE 
BUF 
DRE 
EXO 
FLN 
FPE 
FSQ 
IFE 
IFM 
IRQ 
IWR 
LFL 
MFN 
OFL 
PRL 
RAD 
RUD 
RWT 
TKL 
TNA 



FET ADDRESS OUT OF RANGE 

BUFFER CONTROL WORD ERROR ON 

BUFFER ARGUMENT ERROR ON 

DEVICE ERROR ON FILE 

I/O ON EXECUTE ONLY FILE 

ILLEGAL FILE NAME 

FET PARAMETER ERROR ON 

I/O SEQUENCE ERROR ON FILE 

ILLEGAL EXTENSION OF 

ILLEGAL MODIFICATION OF 

ILLEGAL I/O REQUEST ON FILE 

WRITE ON READ ONLY FILE 

LOCAL FILE LIMIT, FILE 

MULTI-FILE NAME NOT FOUND 

OUTPUT FILE LIMIT, FILE 

PRU LIMIT, FILE 

RANDOM ADDRESS NOT ON FILE 

REQUEST UNDEFINED ON DEVICE 

INDEX ADDRESS OUT OF RANGE FOR 

TRACK LIMIT, FILE 

M.T. NOT AVAILABLE ON FILE 



The logical file name and FET address follow the preceding 

messages. The error processing subroutine ERR is flowcharted in 

figure 9-11 and the overlay 2CK called by ERR is flowcharted in 
figure 9-1 2. 



60454300 A 



9-20 



Entry - (A) = error number 



(err) 



store error 

number in 

ERRA 



EXR 



load and 
execute 

2CK 



Figure 9-11. ERR - Process Error 
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set error 

number , 
reset 

T4 - T7 



yes 





write 

enhanced 

EOI 




Figure 9-12. ERR - Error Processor C2CK) 
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set end 

of device 

status 



■*(rES4) 



set track 

limit error 

status 




Figure 9-12. ERR - Error Processor (2CK) (Continued) 
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map disk 
error 



set error 
status 



set to 

complete 

write (MSP) 



set to 

complete 

read (CPR) 



set to stop 
after writing 

index to 
buffer (MSRX) 




yes 




yes 



IMR 




set to stop 
after trans- 
ferring data 
to user (LDB6) 



no 




set to 
complete 
open (LRIX) 



set to 

complete 

position 

(SFP) 



Figure 9-12. ERR - Error Processor (2CK) (Continued) 
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no 



complete 
FST 




yes 



complete 
FET 



set up to 
dump FET 
via PPDW 



set to drop 
PP DPP 



IMR 



Figure 9-12. ERR - Error Processor (2CK) (Continued) 
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status = 4 



status = 22 



set status 
for FET 



set detailed 
error status 
FET +6 



return 




(A) = 



return 



no 




yes 



set parity 

error flag 

in IMR 



calculate 
buffer 
address 




no 



write pointer 
at old IN 



read new 
next address 



write error 
status in FET+0 



Figure 9-12. ERR - Error Processor (2CK) (Continued) 
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save 
return 
address 



save 

channel 

reservation 

flag 



return 



EXR 



tssue 
message 



2CL 



restore 
direct 
cells 





set mass 
storage 



reset ■ 
error 
processing 



reserve 
channel 



position 



load parity 
error flag 



return 



Figure 9-12. ERR - Error Processor (2CK) (Continued) 
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2CA SUBROUTINES 

Figures 9-13 and 9-14 are the flowcharts of the three subroutines 
residing in overlay 2CA. These are: 

• ISR - Identify special request 

• EVF - Evict mass storage file 

• EPF - Evict permanent file 

Table 9-6 is searched to map the request code in BS+4 into a 
function code stored in PC. 
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search table 
of request 
codes TREQ 




no 



set open 
status in 
EFN routine 



IRQ 



illegal request 



open \ no 
function 



yes 




yes 



store close 

mask in CFA 

routine 



Figure. 9-13. ISR - Identify Special Request C2CA) 
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clear 
current 
track, sector 
and status 



MONITOR 



drop track 
chain 



DTKM 



save number 
of sectors 
returned 




RRF 



RCH 

reserve 
channel 




POS 



position to 
first track 
and sector 

of file 





MSR 



process mass 
storage 
errors 



set file 

modified 

in CFN 




F igure 9-1 4 



EVF/EPF -2CA Subroutines to Evict 
Storage or Permanent File 



a Mass 
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TABLE 9-6. TREQ 



1 ' ■■ 1 

i Request 1 
| Code 1 


Funct ion I 
Code Name I 


Desc ri pt ion 




| 0100 I 


OPE I 


Open, read, no rewind 




I 0104 I 


OPE I 


Open, write, no rewind 




| 0110 I 


OPE I 


Position multifile set 




| 0114 I 


EVI I 


Evi ct 




| 0120 I 


OPE 


Open, alter, no rewind 




I 0130 ! 

i 


CLO 


C lose, no rewi nd 




1 

| 0140 
i 


OPR 


Open, read, rewi nd 




1 

| 0144 


OPR 


Open, write, rewind 




I 0150 


CLU 


C lose, rewi nd 




| 0160 


OPR 


|0pen, alter, rewind 




| 0170 


CLU 


jciose, unload 




I 0174 


| CLU 


jclose, unload, return 




| 0300 


| OPE 


lOpen, read, no rewind 




| 0330 


| CLO 


jclose, no rewind 




I 0340 


| OPR 


lOpen, rewind 




j 0350 


| CLU 


jclose, rewind 




| 0370 


| CLU 


I C lose, unload 

1 V 
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2CB SUBROUTINES 

Figures 9-15 through 9-20 are flowcharts of subroutines in 
overlay 2CB - read mass storage. The following is a list of 
those subroutines; CBS and SBA are not flowcharted. 

RMS - Read mass storage (main routines) 

• LDB - Load CM buffer 

• WCB - Write central buffer 

• EOF - Process EOF 

• EOR - Process EOR 

• CPR - Complete read 

• CBS - Check buffer space 

• SBA - Set buffer addresses 

The flow is for a buffer read. If another read function is 
issued, the flow will be changed. 
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■f if file used 



EXR 

y es / load and 

execute 2CF 

PMS 




RMSX 




clear 
termination 
condition 
(TC) 




EXR 



load and 
execute 2GC 



SMR 



Figure 9-15. 2CB - Read Mass Storage 
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initialize 
for read 



SMS 



set mass 
storage 



SBA - set 

buffer 
addresses 





IMS 



set mass 
storage 



POS 



position 
disk 



SBA - set 

buffer 
addresses 



LDB2 



Figure 9-15. 2CB - Read Mass Storage (Continued) 
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no 




length = 
out - 
(IN+1) 



yes 




length = 

out-(IN+l) 

^limit- first 




yes 




set 


number 


of 


blocks 


in 


buffer 


counter 




Figure 9-16. LOB - Load CM Buffer 



60454300 A 



9-35 



@ 

advance 

sector 

count 

PC = PC+1 




MSR 



process 
error 



(LDB7J 



next sector 

-> T7 
(from link 
byte) 




new track 
T6 
clear sector 

0->T7 



POS 



position 
disk 




store sector 
word count 

-> Tl 



EOR 



yes 




no 



WCB 



Figure 9-16. LDB - Load CM Buffer (Continued) 
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LIMIT \^yes 
reached 



store 


sector in 


CM buffer 


i 


f 


advance 


IN pointer 





store first 
part of 
sector 



store 2nd 
part 



set IN 




store IN 
into FET 




yes 




no 




Figure 9-17. WCB - Write Central Buffer 
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EOF/ E 01 

FS + 4 
(14B) 




yes 



set 


next 


track -»T6 


clear 


sector 


0- 


*>T7 




§ 



decrement 

sector 

count 

PC = PC - 1 



LDBX 



(eofi) 



set EOF 
10->FS+4 




yes 



LDBX 



no 



>LDB2 



Figure 9-18. EOF - Process EOF 
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(eor J 

set 
operation 
complete 
in FS+4" 




Figure 9-19. EOR - Process EOR 
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DCC 



drop 
channel 



update FST 

track FS+2 

sector 

— *FS+3 



termina 
condit 

met 



CPR1 



tion\ no 


clear 
operation 


ion .P * 


complete 
flag 


yes 







update 

accounting 

values 



MSP 




Figure 9-20. CPR - Complete Read 
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POSITION MASS STORAGE ROUTINE 

Figure 9-21 is a partial flowchart of PMS, The position mass 
storage routine is in overlay 2CF. PMS is called from three 
p laces in CIO: 

9 Resident processor PMS 

• RMS in 2CB 

• WMS in 2CD 



PMS - Position mass storage (2CF) 



f PMS J 

PRS 

preset code 

(set 

PMSA ) 



PMSA = RRD - process random read 
RWT - random write 
SKF - skip forward 
SKB - skip backward 
BKS - backspace 
PMSX - rewind 
OPE - open 




Figure 9-21. PMS and Function Processor Return 
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Function processor return 
( SFP ) 



current 
track— *FS+2 
current sec- 
tor — > FS+3 




return 



SRA 



set random 
address 



yes 



SFP2I 



s^ any ^v 

<T MS errorsy 1 

y yes 


no 


read 


ZERO 




intu m 






read 

FET+6 
into DP 






> 


f 






store 
random 
address into 

FET+6 












\ 


t 







return 



Figure 9-21. PMS and Function Processor Return (Continued) 
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CIO-TERMINATION ROUTINES 

Figures 9-22 through 9-24 are flowcharts of the following CIO 
termination routines: 

• UFS - Update file status 

• IOF - Set IN=OUT=FIRST 

• CFN - Complete function 

Routine RRF (reset random FET pointers) is not flowcharted- 
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yes 



no 




yes 



set 
EOR/EOF/EOl 
in FET 




set file 

status 
complete 

in FS+4 



» CFN 




Entered 
from 
MSP only 




set file 
modified 




set write 
mode in FS 



Figure 9-22. UFS - Update File Status 
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© 

set file 
status 

complete 
in FS+4 




no 



set IN = 

OUT = FIRST 

in FET 




CFN 



Figure 9-23. IOF - Set IN = OUT = FIRST 



60454300 A 



9-45 




clear 

track 

interlock 




set file 

not busy 

in FST 



set upper 
status to 
previous 
status 




yes 




clear 
upper 
status bits 
in FET 



-<b 




update 
status 
in FET 



set 
accounting 
values 



MONITOR 



update 
accounting 

UADM 




Figure 9-24. CFN - Complete Function 
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TERMINAL INPUT/OUTPUT ROUTINE TIO 

Figure 9-25 is a flowchart of the terminal input/output (TIO) 
routine- This routine is contained overlay 2CH. TIO is only 
called from the PFN subroutine. 




Figure 9-25- TIO-Te rmi nal Input/Output 
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set RCL 

with recall 

in RA+1 



f RTT J 



read INPUT 
control word 

CP + TINW 



set INPUT 
FET address 
in control 
word 



store input 

control word 

CP + TINW 




MONITOR 

rollout con- 
trol point 
TECH 



set file 

status 
complete 



CRS 



check for 

recall 
requested 



*1 




*1 1R0 will write output to disk on terminal's rollout file 



Figure 9-25. TIO - Terminal Input/Output (Continued) 
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2CI SUBROUTINES 

Figures 9-26 through 9-28 are flowcharts of the following 
subroutines in overlay 2CI. 

• PMT - Process magnetic tape operations 

• HER - Magnetic tape executive request 

• UDT - Unit descriptor table read/write 
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(pMT J 

_L. 



read record/ 
request, re- 
turn informa- 
tion (FET+6) 



yes 



set FC 
= FC+20 





buffer 
argument 
error 



force 
level 17 
74 ► IRQA 





MER 



send request 
to MAGNET 



set FST 
complete 




set RCL 

with recall 

in RA+1 



7\ 

( PMTllH- 



set 
accounting 
information 




Figure 9-26. PMT - Magnetic Tape Operation 
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no 
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ERR J argument 
error 



Figure 9-26. PMT - Magnetic Tape Operation (Continued) 
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set request 
code in 
DP 



set FET 
options in 
DP+1 



CRS 



check recall 
status 





set 2 
of DP 



10 




move FET 
address to 
IR/IR+1 



store level 
number in 
DP+2 







set FIRST 

in LM-1 
and LM-2 



set FL 
in LM-3 



write FC 
to MB 



write DP 
to MB+1 
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MB+2 



UDT 



make 
MAGNET 
request 



return 



Figure 9-27. MER - Magnetic Tape Executive Request 
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.^ va 1 i d -^ 
..^"UDT address 
in FS+1 




no 



set 
read/write 
flag 



JL 



set 
transfer 
length = 3 





no 




tapes not available 



FSQ file sequence error 

ERR 



Figure 9™?.8 UDT - Unit Descriptor Table Read/Write 
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Flowcharts for the multifile label processor (2CJ) are not shown 
Basically, PMT sets up a three-word parameter block and passes 
that information to MAGNET. The format of the three words is as 
f ol lows : 



word 1 



word 2 



word 3 



FC 



function 
code 



12 
DP 



request 
code 



12 
LM-3 



field 
length 



12 



FC+1 



FC+2 



FC+3 



FET 
options 



12 
LM-2 




level 



7 



ubc 




A 



FC+4 




MB 



6 6 

LM-1 



LM 



FIRST 




18 



mlrs 



MB+1 



18 



LM + 1 



LIMIT 



MB+2 



18 



ubc Unused bit count (refer to FET description, NOS 

Reference Manual, Volume 2; publication number is in 
preface) 

mlrs Maximum logical record size 



The request code is taken from the FET. The upper bit (bit 11) 
is set if autorecall was specified. Bit 10 is set if the buffer 
contains data. FET options are from byte 1 of FET+1 and indicate 
the error processing, user processing, and extended label 
processing bits. 
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